sgoudelis/ground-station v0.4.5 on GitHub

Docker Image

Version: 0.4.5
Environment: production
Git Commit: 6a93a98
Build Date: 20260504

Commits in this release:

6a93a98 "Fix Earth's heliocentric vector calculation: correct sign inversion, add regression test for observer elevation at summer solstice."
bb4a8f6 "Standardize Paper component styling: add consistent borderRadius across forms, tables, and settings; enhance button interaction in satellite E2E tests."
9cd6ba9 "Add folder icons in satellite group selectors: implement user/system group icon logic and apply consistent dropdown styling across components."
3accfb3 "Add edit action to sources table: integrate edit button with row actions, enable edit dialog, and prevent row selection on click."
52cb956 "Refactor TLE sync components: rename popover and card files, update translations, and revise text to align with orbital data sync terminology."
d0529cc "Remove satellite sync cards and popover components; add backend revisions for orbit and TLE source management, and seed curated satellite groups for new installations."
35191b6 Integrate orbit service: add abstractions for orbit state handling, propagation input generation, and OMM/TLE compatibility; refactor dependent modules to use the orbit service.
183f2e0 "Add celestial passes feature: implement backend processing, frontend table visualization, and user-configurable table settings."
57d243e Bump version to 0.4.4

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

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

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

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

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

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

# 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.4...v0.4.5