sgoudelis/ground-station v0.4.8

on GitHub

Docker Image

Version: 0.4.8
Environment: production
Git Commit: 566e6d8
Build Date: 20260511

📖 View Project Documentation

Commits in this release:

• 566e6d8 Update default orbital sources to use OMM format, remove pre-seeding of curated system groups
• 9ffca42 Add verticalOffset prop to MapArrowControls for customizable positioning
• 9bae4db Add autocomplete type hints for mission and celestial body searches in target search logic.
• 1bfac68 Relax minimum bandwidth limit for VFO configuration to allow finer adjustments.
• 7a2c682 Refactor settings tests: replace unstable selectors with robust element locators
• 455dc62 Update apply mode chip styles: add support for hot apply mode
• d9d730d Add safeguard to initialize saved state only for backend-loaded locations in LocationForm.
• 64fc611 Apply consistent styling to integration status chips in PreferencesForm and bump postcss to 8.5.14.
• c4fe8ec Refactor PreferencesForm: modularize settings layout, introduce reusable styling helpers, and improve visual consistency across preference sections.
• e69427f Replace PreferenceVerticalIcon with SettingsIcon in navigation config and remove unused import.
• 9dd7839 Introduce reusable settings primitives and refactor preferences and app settings forms for improved modularity.
• 3a72c29 Simplify celestial configuration: remove app-config-based overrides for cache policies and hardcode static values across the codebase.
• abe4a72 Refine FileBrowser dialog padding: add pt override for first dialog content in dark and light themes.
• 6a260a6 Bump server version to 0.4.7.

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

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

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

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

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

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

# 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.7...v0.4.8