FleetView is an open-source monitoring tool for fleets of Starlink dishes, providing live telemetry, obstruction maps, and alerting with a built-in simulator for 40 dishes.

Stars

22

7-day growth

No data

Forks

0

Open issues

0

License

NOASSERTION

Last updated

2026-07-28

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It ships with a realistic simulator that requires no hardware, accounts, or API keys, enabling developers to test and develop monitoring solutions offline.

Who it is for

  • Operators of multiple Starlink dishes (maritime, mining, remote camps, ISP relays)
  • Developers building tools or integrations on top of the Starlink local API
  • Site reliability engineers managing connectivity in remote or mobile environments
  • Network administrators needing a self-hosted, open-source monitoring dashboard

Use cases

  • Monitor real-time telemetry and obstruction maps for a distributed fleet of Starlink dishes
  • Test alerting and fault response scenarios using the optional fault injection in the simulator
  • Explore the undocumented Starlink local gRPC API through the provided write-up and agent code
  • Deploy a lightweight edge agent on a Raspberry Pi to bridge dish data to a cloud dashboard

Strengths

  • Zero hardware dependency for development – 40 simulated dishes run locally with one command
  • Realistic fault injection (offline, obstructed, high latency, thermal shutdown) for testing without waiting for real failures
  • Store-and-forward buffering to SQLite ensures no data gaps when a site loses connectivity
  • WebSocket-based live telemetry updates and a mobile-first dashboard

Considerations

  • Requires Node.js 22+ for built-in node:sqlite, which may not be available on older systems
  • Relies on an undocumented and community-reverse-engineered Starlink local API that can change with firmware updates
  • Not affiliated with SpaceX; the API is unofficial and unsupported, so production usage carries risk

README quick start

FleetView

Open-source monitoring for a fleet of Starlink dishes. Live telemetry, obstruction maps and alerting for every site — maritime, mining, remote camps, ISP relays.


No dish? No problem.

The hard part of building anything for Starlink is that you need a dish — ideally forty of them, in bad weather, on the other side of the planet.

So FleetView ships its own fleet. One command starts 40 simulated dishes that speak the real Starlink local gRPC protocol, each with believable telemetry, plus fault injection you can trigger from a terminal:

npm run setup   # once
npm run dev     # 40 dishes + agent + cloud + dashboard

Open http://localhost:5273. That's the screenshot above, running on your machine in about ten seconds — no hardware, no accounts, no API keys, no Docker.

Point it at a real dish when you have one. It's the same agent either way.

Break things on purpose

Every simulated dish has a control plane. Knock a vessel offline and watch the map turn red, the alert fire, and the site drop into "needs attention":

curl -X POST http://127.0.0.1:8799/scenario \
  -H 'content-type: application/json' \
  -d '{"id":"mv-pacific-voyager","mode":"obstructed"}'

Modes: normal · offline · obstructed · high_latency · degraded · thermal Reset everything with curl -X POST http://127.0.0.1:8799/scenario/reset.

This is the bit that's genuinely hard to get any other way. Reproducing a thermal shutdown, a mid-poll reboot, or a tree growing into the sky view is otherwise a matter of waiting months and getting lucky.

What you get

Per-site detail — latency/throughput history, dish info, event log, and a rendered sky obstruction map showing exactly what's blocking the view.Alerting — site down (debounced so blips don't page you), obstruction, packet loss, high latency. Slack and email, or console-only with nothing configured.
Fleet tableMobile
  • Live, not lagged — telemetry lands in seconds, over a WebSocket.
  • Any dish — reads the local API directly, so no reseller/account-manager gating.
  • Store-and-forward — the agent buffers to local SQLite; a site that loses its uplink backfills when it returns instead of leaving a hole in your charts.
  • **Mobile-f

Description

Open-source Starlink fleet monitoring — live telemetry, obstruction maps and alerting for every site. Includes a 40-dish gRPC simulator, so you can run the whole thing with no hardware.

Related repositories

Similar projects matched by category, topics, and programming language.

S40911120
Featured
S40911120 GitHub avatar

recensa

Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.

AI & Machine LearningLarge Language Models
67
deerwork-ai
Featured
deerwork-ai GitHub avatar

deer-workflow

An open-source Dynamic Workflow runtime that combines deterministic TypeScript orchestration with replaceable Agent runtimes.

AI & Machine LearningLarge Language Models
312
yaojingang
Featured
yaojingang GitHub avatar

TokHub

TokHub is an open-source monitoring, recommendation, and OpenAI-compatible gateway system for AI API intermediaries, combining public status pages, supplier rankings, user workspaces, layered probing, metering, alerts, encrypted keys, and Docker self-hosting.

AI & Machine LearningBackend & APIs
189