sgoudelis/ground-station v0.8.18

on GitHub

Docker Image

Version: 0.8.18
Environment: production
Git Commit: 5e1cdb4
Build Date: 20261008

📖 View Project Documentation

Commits in this release:

• 5e1cdb4 chore(version): bump to v0.8.18
• e4fd84b feat(vfo-squelch): enhance voice squelch handling with hiss filtering and extended VAD close delay options
• e5dd99b feat(dashboard): add mobile/tablet detection and simplify WakeLockStatus logic
• 1598975 refactor(dashboard): simplify WakeLockStatus layout structure
• 18d43c7 feat(earthview): add tests and improve recent group handling in satellite selector
• 17016bb feat(earthview): add shared satellite info dialog and improve map interaction workflows
• c8efee8 refactor(waterfall): remove unused Chip for joined SDR state in settings-column
• 1e5fb7b feat(waterfall): replace "watch" functionality with "join" for SDR sessions
• 3d73880 feat(sdr-capabilities): implement SDR parameter probing and caching with frontend integration
• d47b4a6 feat(waterfall): add SDR watching support and update UI/logic for takeover choices
• b90cc71 chore(deps): update Mako to 1.4.2 and source-map-js to 1.2.2
• be866c3 chore(deps): update Mako to 1.4.2 and source-map-js to 1.2.2
• b29d069 feat(satellites): add dialog-specific coverage fit utilities and adjust map padding
• d17f293 feat(target): add shared satellite tracking utilities and coverage extent support
• 3a04c69 feat(target): pass monitoredRows prop to CelestialPasses
• b10d357 feat(target): add row context menu for satellite passes with expanded actions

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

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

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

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

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

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

# 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.17...v0.8.18