sgoudelis/ground-station v0.8.16 on GitHub

Docker Image

Version: 0.8.16
Environment: production
Git Commit: affe3a4
Build Date: 20260930

Commits in this release:

affe3a4 chore(version): bump to v0.8.16
57219df test(satellites): update e2e tests to reflect direct Sources page render
76e4164 test(setup-wizard): improve logout retry logic to handle transient delays
ebc6106 feat(celestial): refine object label logic and add unfocused label toggle
96622f0 feat(celestial): add unfocused label toggle and refine label rendering logic
2914b31 feat(celestial): adjust dimmed stroke opacity for improved visibility
17ac4a9 feat(satellites): add orbital data pages and enhance navigation structure
4390397 test(setup-wizard): make logout retryable to handle dropped CI connections
7335b5e feat(satellites): update transmitter column to use flexible width
8cbf564 feat(satellites): adjust column width for orbit first seen field
0218eb2 feat(satellites): adjust column widths for improved table layout
66b8f0b feat(satellites): add orbit lifecycle timestamps and enhance catalog functionality
9b96de1 feat(waterfall): add asset URL resolution for decoded and observation files
f458b12 feat(celestial): adjust row height and padding for improved table spacing
32f3ace feat(celestial): consolidate catalog and remove monitored targets page
e24e1f9 feat(satellites): improve filter UI and add "no filters applied" state
f163814 feat(satellites): improve pagination, filtering, and theme defaults
f5f05d6 feat(satellites): enhance catalog search and filtering capabilities

Pull the Docker image:

For AMD64 systems:

docker pull --platform linux/amd64 ghcr.io/sgoudelis/ground-station:0.8.16

For ARM64 systems (Raspberry Pi, etc):

docker pull --platform linux/arm64 ghcr.io/sgoudelis/ground-station:0.8.16

Or pull architecture-specific tags directly:

# AMD64
docker pull ghcr.io/sgoudelis/ground-station:0.8.16-amd64

# ARM64
docker pull ghcr.io/sgoudelis/ground-station:0.8.16-arm64

Run the container:

Option 1: With SoapySDR Remote Server Discovery (Recommended)

Uses host networking to enable mDNS discovery of SoapySDR remote servers:

# AMD64
docker run -d \
  --platform linux/amd64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  --device=/dev/bus/usb \
  --privileged \
  -v /path/to/data:/app/backend/data \
  ghcr.io/sgoudelis/ground-station:0.8.16

# ARM64 (Raspberry Pi, etc)
docker run -d \
  --platform linux/arm64 \
  --network host \
  --name ground-station \
  --restart unless-stopped \
  -v /dev:/dev \
  --privileged \
  -v /path/to/data:/app/backend/data \
  ghcr.io/sgoudelis/ground-station:0.8.16

Option 2: Standard Bridge Mode (No SoapySDR Remote Discovery)

Uses standard bridge networking with port mapping:

# AMD64
docker run -d \
  --platform linux/amd64 \
  -p 7000:7000 \
  --name ground-station \
  --restart unless-stopped \
  --device=/dev/bus/usb \
  --privileged \
  -v /path/to/data:/app/backend/data \
  ghcr.io/sgoudelis/ground-station:0.8.16

# ARM64 (Raspberry Pi, etc)
docker run -d \
  --platform linux/arm64 \
  -p 7000:7000 \
  --name ground-station \
  --restart unless-stopped \
  -v /dev:/dev \
  --privileged \
  -v /path/to/data:/app/backend/data \
  ghcr.io/sgoudelis/ground-station:0.8.16

Note: Replace /path/to/data with your desired data directory path. For ARM64, using -v /dev:/dev ensures all USB devices are accessible.

After starting the container, access the web interface at http://<YOUR_HOST>:7000

First startup note: On first run, it can take up to ~30 seconds after container startup for the frontend to become available.
You can watch startup progress with:
docker logs -f --tail=100 ground-station

Upgrading an existing container:

# Stop and remove the existing container
docker stop ground-station
docker rm ground-station

# Pull the new version
docker pull ghcr.io/sgoudelis/ground-station:0.8.16

# Run the container again (use the appropriate command above for your architecture)

Multi-arch support:

This image supports linux/amd64 and linux/arm64 platforms. Docker will automatically pull the correct architecture for your system.

Full Changelog: v0.8.15...v0.8.16