retina-node

Orchestrator repository for Retina passive radar nodes. Manages docker-compose configuration and Mender OTA artifact generation.

Deploy to nodes running owl-os via the Mender dashboard. See owl-os README for installation instructions.

For development/testing without Mender, see STANDALONE.md.

Web Interfaces

Service	Port	URL	Description
retina-gui	80	http://owl.local	Node management, SSH keys, service links
blah2	49152	http://owl.local:49152	Passive radar UI
tar1090	8078	http://owl.local:8078	ADS-B aircraft map
adsb2dd	49155	http://owl.local:49155	Delay-Doppler truth overlay

SSH Access

Add your SSH public key via the web GUI at http://owl.local:

1. On your computer, copy your public key: cat ~/.ssh/id_ed25519.pub
2. Open http://owl.local in a browser
3. Paste the key and click "Add Key"
4. SSH in: ssh node@owl.local

Keys persist across reboots and OTA updates.

Useful Commands (Mender Terminal)

Check container status

sudo docker ps

View logs for a specific container

sudo docker logs <container-name>

Restart / update config

cd /data/mender-docker-compose/current/manifests
sudo docker compose -p retina-node run --rm config-merger
sudo docker compose -p retina-node up -d --force-recreate

Node Access

Access nodes via Mender troubleshooting terminal.

/data/
├── mender-docker-compose/current/manifests/
│   ├── docker-compose.yaml    # Deployed compose file
│   └── .env                   # Environment vars (copied by config-merger and autogenerated)
│
└── retina-node/
    ├── config/
    │   ├── user.yml           # User config overrides (edit this)
    │   ├── config.yml         # Merged blah2 config (auto-generated)
    └── blah2/
        ├── save/              # Persistent radar data
        ├── script/            # Runtime scripts
        └── test/              # Test data

Configuration

Config-merger generates config files at startup by merging:

default.yml → user.yml → forced.yml

Later files override earlier ones.

Editing Config on a Node

# 1. Edit config
sudo nano /data/retina-node/config/user.yml

# 2. Regenerate .env and restart services
cd /data/mender-docker-compose/current/manifests
sudo docker compose -p retina-node run --rm config-merger
sudo docker compose -p retina-node up -d --force-recreate

# 3. Verify
cat /data/retina-node/config/config.yml

First Deployment

After initial Mender deployment, run config-merger and restart to apply config:

cd /data/mender-docker-compose/current/manifests
sudo docker compose -p retina-node run --rm config-merger
sudo docker compose -p retina-node up -d --force-recreate

Why restart is needed: Docker Compose reads environment variables from .env at container start time, not when the file changes. Config-merger generates .env with location and ADS-B settings, but services that started before this file existed won't have the correct values. The restart ensures all services pick up the generated configuration. This is not needed if using the OWL-OS set-up wizard.

Editing Default/Forced Config

Edit files in config/ directory in this repo, then rebuild and deploy.

Creating a Release

1. Update docker-compose.yml with desired package versions
2. Tag with git tag vX.X.X and push
3. CI workflow generates Mender artifact and uploads to dashboard