sgoudelis/ground-station v0.8.22

on GitHub

Docker Image

Version: 0.8.22
Environment: production
Git Commit: 529d6d5
Build Date: 20261026

📖 View Project Documentation

Commits in this release:

• 529d6d5 chore(version): bump to v0.8.22
• c0c2c7d feat(telemetry): add LASARSAT AX.25 beacon parser and viewer support
• e223e87 feat(frontend): enhance satellite group button styles and focus behavior
• 3552de4 feat(frontend): optimize connection popover rendering and enhance traffic stats tracking
• 02533ae fix(frontend): maintain scroll position in VFO settings column during tab switches
• e4a8ebd fix(frontend): adjust tracking navigation badge positioning for better alignment
• 1a5f02d feat(frontend): add satellite links and tooltips in LoRa decoded packets
• 3ccd2fe feat(frontend): refine LoRa callsign hints in decoded packets display
• 97af279 feat(frontend): add custom padding to error dialog content for improved spacing
• e25612d feat(frontend): add reusable map title controls and enable fullscreen and home centering functions
• bb97783 feat(frontend): reorganize VFO panel to improve component grouping and readability
• dd9e3b7 feat(frontend): add live status indicators for tracking navigation and file browser enhancements
• e7cf5d0 feat(frontend, backend): enhance VFO filtering, rotator tracking, and image handling
• 9eaeefc feat(backend, frontend): implement satellite tracking context and observer updates with tests
• dbbc8df feat(frontend, backend): implement command expiration, validation, and backend epoch tracking
• 60f5ef9 feat(frontend): optimize globe fit behavior in satellite coverage with subpixel drift handling
• 351631d chore(deps): update backend and frontend dependencies to latest versions

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

# ARM64
docker pull ghcr.io/sgoudelis/ground-station:0.8.22-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.22

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

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

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

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

# 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.21...v0.8.22