sgoudelis/ground-station v0.4.1

on GitHub

Docker Image

Version: 0.4.1
Environment: production
Git Commit: 816ca25
Build Date: 20260427

📖 View Project Documentation

Commits in this release:

• 816ca25 "Add cooperative yielding during large directory scans to prevent blocking and extend emit_file_browser_* methods with optional room targeting."
• 6350dd2 "Introduce WaterfallEngineProvider to manage worker-based waterfall rendering and refactor waterfall-island to use new provider abstraction."
• 7376695 "Suppress toast notifications for rotator and rig connection events, and target change updates to reduce noise in the UI."
• 3b54c71 "Tighten weak auto-scaling presets: reduce padding and remove minimum span constraint for improved responsiveness."
• bab6aa9 "Adjust weak signal auto-scaling: widen padding, enforce minimum span to reduce harsh scaling."
• 6c8c22c "Remove calibration offsets in demodulators, standardize RF power calculations, and refine FFT normalization for consistent signal analysis and visualization."
• 4a567f6 "Refactor target-satellite selector handling: normalize resource IDs, resolve observation tracker IDs, and refine logic for matching observations and assigned resources."
• fdadefe "Update README to reflect multi-target tracking console improvements and add new ISS-focused example image"
• d6c5cb6 "Enhance rotator gauge handling: add robust validations for finite values and geometry, refactor logic for null safety in render paths, and update event handling for target deletion and SDR settings."
• e58f890 "Add multi-target tracking fleet feature to README for improved clarity on functionality"
• c96ac8f "Enhance fleet target row visuals: add hover effect, smooth background color transition, and elevated background for inactive state."
• 2c1f4e2 "Add badges for last release date and last commit to README.md for improved project visibility."
• 400d9f6 "Bump version to 0.4.0 to reflect new feature updates and improvements."

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

# ARM64
docker pull ghcr.io/sgoudelis/ground-station:0.4.1-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 \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.4.1

# 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 \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.4.1

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 \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.4.1

# 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 \
  -e GS_ENVIRONMENT=production \
  -e GR_BUFFER_TYPE=vmcirc_mmap_tmpfile \
  ghcr.io/sgoudelis/ground-station:0.4.1

Note: Replace /path/to/data with your desired data directory path. Option 1 (host networking) is required for automatic mDNS discovery of SoapySDR remote servers. Option 2 works for local SDRs and all other features. 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

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

# 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.4.0...v0.4.1