Starlink dish status

When a Starlink dish is on the same network as your Aircast device, Aircast reads the dish’s local API and shows its health right on the dashboard — so you can see obstruction, latency, loss, throughput, and alerts without a separate app.

This reads the dish’s local status API for monitoring only — it does not change how traffic is routed. For getting a Starlink Mini online and wired to the Pi, see the Starlink Mini uplink guide.

The Starlink card

Open Network in the dashboard. When a dish is reachable, a Starlink card appears alongside the cellular and Wi-Fi cards. If this device has no dish, the card stays hidden — it only shows once a dish has answered, so it won’t clutter cellular-only devices.

Readout	What it means
Status	online, degraded, or unreachable — the headline state of the dish.
Latency	round-trip time to the Starlink point of presence, in milliseconds.
Loss	packet drop rate on the uplink; sustained loss above 10% marks the link degraded.
Obstruction	fraction of the sky currently blocked; a warning shows when the dish is obstructed.
Downlink / Uplink	current throughput in each direction, in Mbps.
Uptime	how long the dish has been running since its last reboot.
Firmware	the dish’s reported software version.

The badge on the card summarizes the link at a glance:

onlineThe dish answered and the link is healthy — clear sky, low loss, no alerts.

degradedThe dish is present but struggling: obstructed, high packet loss, or an active alert (thermal throttle, motors stuck, unexpected location). The card explains which.

unreachableA dish was seen before but the local API is not answering now — the dish is unplugged, powered off, or the address is wrong.

A degraded or unreachable dish does not flip the device’s overall status to “attention needed.” The dish is a secondary readout; your device keeps streaming over whatever uplink is active. The card shows the detail so you can decide.

Setting the dish address

Aircast reaches the dish’s local API at a fixed address. The default — 192.168.100.1:9200 — is where a standard Starlink dish serves its API, so most setups need no change. If your dish is reached at a different address (for example behind a router that remaps it), set it here:

Open Settings in the dashboard and find the Starlink dish card.
Enter the address as host:port (a hostname or IP, then a colon and the port).
Press Save. The change is stored on the device and takes effect within a few seconds — no reboot. An invalid address (missing port, bad port number) is rejected with an error.

The setting lives on the Settings page rather than inside the Starlink card because the card is hidden until a dish answers — so you can point Aircast at the dish before it’s reachable. After saving, watch the Network page: the card appears (or flips to “online”) once the dish responds at the new address.

Saving a well-formed address always succeeds even if nothing answers there yet — Aircast can’t know a dish is present until it polls. If the card then shows unreachable, double-check the address and that the dish is on the same network as the device.

On This Page