sgoudelis/ground-station v0.7.9

on GitHub

Docker Image

Version: 0.7.9
Environment: production
Git Commit: af90154
Build Date: 20260703

📖 View Project Documentation

Commits in this release:

• af90154 feat(celestial): add context menu for targets in monitored grid and passes views
• 2634bd8 docs(README): update SDR management section image and add new asset file
• 8975213 docs(README): remove GNSS-SDR integration note
• fa1a83a docs(workflow): simplify ARM64 notes in release workflow
• 5bda8f3 docs(release): add note on frontend delay during first container startup
• 4108123 chore(dependencies): update backend dependencies to latest versions
• 8260ba2 refactor(celestial): improve target key generation with enhanced fallback logic
• 63bd075 refactor(vfo-settings): remove unused transmitter editing functionality
• c2197b6 feat(transmitters): normalize transmitter IDs and add source transmitter mappings
• 2b44da9 feat(earthview): add touch handling to markers for improved interaction
• 1f991e9 refactor(celestial,backend): unify target key generation for missions and bodies
• d03e8b9 feat(earthview): add context menu for satellite markers with advanced actions
• a900041 refactor(rig-control): centralize tracking state logic with buildTrackingPayload
• a6be0d6 feat(earthview): implement context menu for satellite passes with advanced actions
• 820bfc8 feat(celestial): adjust target-slot badge dimensions for enhanced compactness
• 4cf69e8 refactor(celestial): remove unused LABEL_INDENT_STEP and simplify label positioning logic
• 05995d6 feat(celestial): enhance target-slot resolution logic for solar bodies
• 2ceae7f feat(celestial): restructure target-slot badge rendering logic
• 64c3bba feat(celestial): add label offset logic for bodies with target-slot badges
• 020a6cb feat(celestial): refine target-slot badge scaling for improved consistency
• 50fcf8a docs(README): update with release notes for v0.7.8
• 6c81a36 chore(version): bump version to 0.7.8

Pull the Docker image:

For AMD64 systems:

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

For ARM64 systems (Raspberry Pi, etc):

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

Or pull architecture-specific tags directly:

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

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

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

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

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

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

# 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.7.8...v0.7.9