sgoudelis/ground-station v0.8.23

on GitHub

Docker Image

Version: 0.8.23
Environment: production
Git Commit: d50e4b9
Build Date: 20261029

📖 View Project Documentation

Commits in this release:

• d50e4b9 chore(version): bump to v0.8.23
• 6e74f55 feat(frontend): add reusable ImageViewerDialog for SSTV and general image previews
• df5bae0 fix(frontend): adjust dialog dimensions to use dynamic viewport height in DecodedPacketsDrawer and FileBrowser
• 303372a fix(frontend): adjust dialog height to improve UX in DecodedPacketsDrawer and FileBrowser
• 39539d5 fix(backend): refine satellite deletion logic to preserve shared items
• fd08c55 test(backend): add unit tests for satellite and orbit deletion workflows
• 3fde428 test(filebrowser): add toast behavior tests for PurgeDialog
• 89b56aa test(scheduler): extend timeout for monitored satellite dialog retries on CI
• 4ddd0ca fix(scheduler): fallback to option label before translation lookup
• d450b7a test(scheduler): add unit tests for MonitoredSatelliteDialog behavior
• 19774b2 feat(backend): add robust SSTV signal decoding with new tone detection and audio resampling
• 12887e5 fix(frontend): center map on selected position when following mode is active
• 8e065fb fix(frontend): prevent page scroll during solar system wheel zoom interactions
• 8e9b619 fix(frontend): prevent page scroll during solar system wheel zoom interactions
• 3bd3b29 refactor(frontend): replace custom pagination with reusable GridPaginationActions component for celestial passes table
• a1f9e0b chore(release): preflight identity, auth and push access, add failure rollback

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

# ARM64
docker pull ghcr.io/sgoudelis/ground-station:0.8.23-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 \
  -e GS_HTTP_PORT=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.23

# ARM64 (Raspberry Pi, etc)
docker run -d \
  --platform linux/arm64 \
  --network host \
  -e GS_HTTP_PORT=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.23

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.23

# 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.23

Port selection: In host-network mode, change GS_HTTP_PORT=7000 to your desired HTTP port, such as GS_HTTP_PORT=8080. Docker ignores -p in this mode. In bridge mode, change the host side of -p 7000:7000, such as -p 8080:7000; keep the container side at 7000. The backend remains on 127.0.0.1:7001 inside the container.

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>:<HTTP_PORT> (7000 by default).

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.23

# Run the container again (use the appropriate command above for your architecture and retain your HTTP port choice)

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.22...v0.8.23