Open Source · MIT License

Situational Awareness,
Anywhere.

Field-deployable mapping, real-time position tracking, and team coordination. Runs on portable hardware. No internet. No cloud. No dependencies.

525+
Integration Tests
7
Docker Containers
0
Cloud Dependencies

Everything you need
in the field.

A complete tactical platform with mapping, communications, and coordination — all running on hardware you can carry in a backpack.

Offline Maps

Vector and raster tile serving via TileServer GL. Download regions for offline use. Multiple styles including satellite, topo, and dark mode.

Blue Force Tracking

Real-time GPS position broadcasting via WebSocket. Track team members on the map with callsign labels, trail history, and status indicators.

Secure Messaging

Channel-based and direct messaging with real-time delivery, typing indicators, message history, and unread badges. TLS-secured transport on local networks.

Markers

Place points, draw lines, and define polygons on the map. Categorize with names and photos, apply custom styling, and sync in real-time to all connected clients.

File Sharing

Upload, download, and share files across the team. Supports GeoJSON, GPX, KML overlays with interactive map visualization and import/export.

Push-to-Talk Voice

Walkie-talkie style voice communications with real-time AudioWorklet streaming at 60ms latency. Spacebar PTT, volume control, and visual indicators.

Video Streaming

Share IP camera and drone feeds via HLS, RTSP, RTMP, or direct URL. RTMP push support for OBS and FFmpeg. Live broadcasts with WebRTC peer-to-peer streaming.

Auth & RBAC

Password authentication with argon2id hashing and JWT tokens. Three-tier role system (observer, operator, admin) enforced on every endpoint.

Server Federation

Connect independent GroundWave servers to share positions, markers, and chat over WAN. Pre-shared key trust model with echo prevention.

Navigation & Bearing

Real-time bearing and distance lines to any target with HUD overlay. "Navigate to" buttons on markers and users. Shared bearing lines visible to all.

Turn-by-Turn Routing

Offline vehicle navigation powered by Valhalla and OpenStreetMap. Auto, bicycle, and pedestrian profiles with maneuver HUD and auto-reroute.

Turn-by-Turn Routing

Offline-capable vehicle navigation via self-hosted Valhalla. Multiple profiles (auto, bicycle, pedestrian) with auto-reroute on deviation and maneuver HUD.

# Deploy GroundWave on any hardware
$ ./setup.sh
 
GroundWave Setup v1.0
Detecting architecture... arm64
Loading Docker images... done
Starting containers...
 
groundwave-db  running
groundwave-app  running
groundwave-tilesrunning
groundwave-web  running
groundwave-router running
 
Ready at https://groundwave.local

Deploy in minutes.
No internet required.

GroundWave ships as a self-contained release archive. One script loads the Docker images, starts the containers, and generates TLS certificates. Clients connect via browser — no app install needed.

  • Single setup.sh script — works on x86 and ARM
  • Self-signed CA with trusted HTTPS for offline networks
  • First-run setup wizard for callsign, tiles, and configuration
  • Offline-resilient clients with IndexedDB cache and message queuing
  • Multi-architecture Docker images (amd64 + arm64)

Seven containers.
Complete platform.

Docker Compose orchestrates the entire stack. Five core containers plus two opt-in services (CoT Bridge, Valhalla Router), each with a single responsibility.

Nginx
Reverse Proxy + Static Files
:80 / :443
App Server
Node.js + Express + Socket.IO
:3000
Tile Server
TileServer GL
:8080
Database
PostgreSQL + PostGIS
:5432
RTSP Proxy
mediamtx + FFmpeg
:8554 / :8888
CoT Bridge
Node.js · TAK Interop
:4242 (opt-in)
Valhalla Router
Valhalla · OSM Data
:8002 (opt-in)

Built for teams
that operate anywhere.

GroundWave serves any group that needs coordination without relying on commercial infrastructure.

Search & Rescue

Coordinate search teams across remote terrain with real-time position tracking, sector markers, and offline mapping where cell service doesn't exist.

Disaster Response

When infrastructure is down, GroundWave provides independent communications. Map damage zones, track responders, and share situation reports — all without internet.

Community Emergency Teams

CERT and volunteer organizations can deploy their own comms network for training exercises and real emergencies with affordable, off-the-shelf hardware.

Outdoor Recreation

Backcountry expeditions, trail races, and adventure groups can track participants, share waypoints, and communicate in areas with zero cell coverage.

Event Coordination

Manage festivals, races, and large-scale events with real-time staff tracking, markers for facilities, and instant team messaging.

Rural Communities

Isolated communities and off-grid groups can establish their own coordination network. Solar-powered deployments provide indefinite operation.

Runs on hardware
you can carry.

Three reference builds from budget-friendly to high-performance. All use off-the-shelf components with no proprietary hardware.

Budget
Raspberry Pi 5
  • 4GB RAM, quad-core ARM
  • 32GB microSD storage
  • USB battery bank powered
  • Supports 10-15 concurrent users
Performance
Mini PC
  • 16GB+ RAM, modern x86
  • 512GB+ NVMe SSD
  • High-capacity LiFePO4 battery
  • Supports 100+ concurrent users

Ready to deploy?

GroundWave is free to use during the beta period. The source code will be publicly available when GroundWave exits beta.