# sdr-enthusiasts/docker-adsb-ultrafeeder architecture

> Architecture diagram of the GitHub repository sdr-enthusiasts/docker-adsb-ultrafeeder, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sdr-enthusiasts/docker-adsb-ultrafeeder
- Repository: https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder

## Overview

Ultrafeeder collects and decodes ADS-B, presents aircraft and system data locally, forwards aircraft and MLAT data to configured aggregators, and exposes statistics for monitoring. The graph follows these documented product stages and includes configuration and service-runtime components from the tree. Most implementation files were not sampled, so relationships among them are included only where the README documents the behavior; paths for unsampled visualization components use the available enclosing directory.

Main entry points: [`rootfs/etc/s6-overlay/s6-rc.d/readsb/run`](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/readsb/run) (readsb decoder), [`rootfs/scripts/interpret_ultrafeeder_config`](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/scripts/interpret_ultrafeeder_config) (Config interpreter), [`rootfs/etc/s6-overlay/s6-rc.d/aggregator-urls/run`](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/aggregator-urls/run) (Aggregator URLs), [`rootfs/etc/s6-overlay/s6-rc.d/mlathub/run`](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/mlathub/run) (MLAT hub)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Ingest and decode"]
  node_readsb["readsb decoder<br/>[run]"]
end

subgraph group_distribution["Data distribution"]
  node_aggregator_urls["Aggregator URLs<br/>[run]"]
  node_mlat_client["MLAT client<br/>[run]"]
  node_mlat_hub["MLAT hub<br/>[run]"]
end

subgraph group_visualization["Visualization"]
  node_tar1090["tar1090 map"]
  node_graphs1090["graphs1090 graphs"]
  node_timelapse["timelapse1090"]
end

subgraph group_operations["Configuration and metrics"]
  node_config["Config interpreter"]
  node_stats["Stats collector<br/>[run]"]
end

node_operator(("Feeder operator"))
node_sdr["SDR or source"]
node_aggregators["ADSB aggregators"]
node_mlat_servers["MLAT servers"]
node_monitoring["Prometheus or InfluxDB"]
node_grafana["Grafana"]

node_operator -->|"configures"| node_config
node_sdr -->|"provides ADSB"| node_readsb
node_config -->|"configures"| node_readsb
node_readsb -->|"feeds display"| node_tar1090
node_readsb -->|"provides data"| node_graphs1090
node_readsb -->|"provides data"| node_timelapse
node_config -->|"configures"| node_aggregator_urls
node_readsb -->|"forwards ADSB"| node_aggregator_urls
node_aggregator_urls -->|"sends ADSB"| node_aggregators
node_mlat_client -->|"sends MLAT"| node_mlat_servers
node_mlat_hub -->|"returns MLAT"| node_readsb
node_mlat_hub -->|"consolidates results"| node_aggregators
node_readsb -->|"provides statistics"| node_stats
node_stats -->|"exports metrics"| node_monitoring
node_monitoring -->|"visualizes metrics"| node_grafana

click node_config "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/scripts/interpret_ultrafeeder_config"
click node_readsb "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/readsb/run"
click node_aggregator_urls "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/aggregator-urls/run"
click node_mlat_client "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/mlat-client/run"
click node_mlat_hub "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/mlathub/run"
click node_tar1090 "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs"
click node_graphs1090 "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs"
click node_timelapse "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs"
click node_stats "https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/adsbx-stats/run"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readsb toneBlue
class node_aggregator_urls,node_mlat_client,node_mlat_hub toneAmber
class node_tar1090,node_graphs1090,node_timelapse,node_mlat_servers toneMint
class node_config,node_stats toneRose
class node_operator,node_sdr,node_aggregators,node_monitoring,node_grafana toneIndigo
```

## Components

### Ingest and decode

- [readsb decoder](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/readsb/run): `rootfs/etc/s6-overlay/s6-rc.d/readsb/run`

### Data distribution

- [Aggregator URLs](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/aggregator-urls/run): `rootfs/etc/s6-overlay/s6-rc.d/aggregator-urls/run`
- [MLAT client](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/mlat-client/run): `rootfs/etc/s6-overlay/s6-rc.d/mlat-client/run`
- [MLAT hub](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/mlathub/run): `rootfs/etc/s6-overlay/s6-rc.d/mlathub/run`

### Visualization

- [tar1090 map](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs): `rootfs`
- [graphs1090 graphs](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs): `rootfs`
- [timelapse1090](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/tree/main/rootfs): `rootfs`

### Configuration and metrics

- [Config interpreter](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/scripts/interpret_ultrafeeder_config): `rootfs/scripts/interpret_ultrafeeder_config`
- [Stats collector](https://github.com/sdr-enthusiasts/docker-adsb-ultrafeeder/blob/main/rootfs/etc/s6-overlay/s6-rc.d/adsbx-stats/run): `rootfs/etc/s6-overlay/s6-rc.d/adsbx-stats/run`

### Other components

- **Feeder operator**
- **SDR or source**
- **ADSB aggregators**
- **MLAT servers**
- **Prometheus or InfluxDB**
- **Grafana**

## Connections

- Feeder operator → Config interpreter: configures (evidence: `README.md`)
- SDR or source → readsb decoder: provides ADSB (evidence: `README.md`)
- Config interpreter → readsb decoder: configures (evidence: `README.md`)
- readsb decoder → tar1090 map: feeds display (evidence: `README.md`)
- readsb decoder → graphs1090 graphs: provides data (evidence: `README.md`)
- readsb decoder → timelapse1090: provides data (evidence: `README.md`)
- Config interpreter → Aggregator URLs: configures (evidence: `README.md`)
- readsb decoder → Aggregator URLs: forwards ADSB (evidence: `README.md`)
- Aggregator URLs → ADSB aggregators: sends ADSB (evidence: `README.md`)
- MLAT client → MLAT servers: sends MLAT (evidence: `README.md`)
- MLAT hub → readsb decoder: returns MLAT (evidence: `README.md`)
- MLAT hub → ADSB aggregators: consolidates results (evidence: `README.md`)
- readsb decoder → Stats collector: provides statistics (evidence: `README.md`)
- Stats collector → Prometheus or InfluxDB: exports metrics (evidence: `README.md`)
- Prometheus or InfluxDB → Grafana: visualizes metrics (evidence: `README.md`)
