Skip to main content

Quick Start

Deploy ShadowBroker in minutes with Docker or Podman.

Data Layers

Explore all 20+ intelligence layers available in the dashboard.

API Reference

Integrate with the ShadowBroker REST API from your own tools.

Architecture

Understand how the backend scheduler and frontend map work together.

What is ShadowBroker?

ShadowBroker is a self-hosted, real-time geospatial intelligence platform that aggregates dozens of public open-source data feeds into a single dark-ops map interface. It is built for analysts, researchers, and enthusiasts who want a single-pane-of-glass view of global activity. A surprising amount of global telemetry is already public — aircraft ADS-B broadcasts, maritime AIS signals, satellite orbital data, earthquake sensors, and environmental monitoring networks. ShadowBroker brings them together.
ShadowBroker is built entirely on publicly available, open-source intelligence (OSINT) data. No classified, restricted, or non-public data sources are used. No user data is collected or transmitted — the dashboard runs entirely in your browser against a self-hosted backend.

Key capabilities

Aviation

Commercial, private, military, and tracked aircraft via ADS-B with holding-pattern detection and flight trail accumulation.

Maritime

25,000+ vessels via AIS WebSocket stream, US Navy carrier strike group tracker, and superyacht monitoring.

Satellites

2,000+ orbital assets with real-time SGP4 propagation, classified by mission type.

Geopolitics

GDELT conflict events, live Ukraine frontline, and region intelligence dossiers on right-click.

Signal Intelligence

GPS jamming zone detection via NAC-P degradation analysis with grid-based severity mapping.

Environmental

NASA FIRMS fire hotspots, NOAA space weather, IODA internet outage monitoring, and USGS earthquakes.

Satellite Imagery

NASA GIBS MODIS Terra daily imagery, Esri sub-meter basemap, and on-demand Sentinel-2 intel cards.

SDR Radio

500+ KiwiSDR public receivers plotted worldwide with embedded live radio tuner.

Surveillance

2,000+ CCTV feeds from London, NYC, Austin, Singapore, and custom sources.

Technology stack

ShadowBroker is built with Next.js and MapLibre GL on the frontend, and FastAPI with Python on the backend. The backend runs a recurring scheduler that fetches, normalizes, and caches data from all sources, serving the frontend via a compressed REST API.

Docker deployment

Single-command deployment with Docker Compose or Podman.

Kubernetes / Helm

High-availability deployment with Helm chart for home-lab clusters.

License

ShadowBroker is released under the AGPL-3.0 license. It is designed for educational and personal research use. See individual API provider terms of service for data usage restrictions.

Build docs developers (and LLMs) love