Starlink obstruction errors on boats — and the diagnostic order we run on every service call.
When Starlink stops working on a boat, the cause is almost never coverage. It is one of four install-side issues, and the diagnostic order is reliable enough that you can usually find the problem in 15 minutes. Here is the workflow we use.
"Starlink isn't working on my boat" is the call we get most often from owners we did not originally install. The frustration is real and the troubleshooting can feel mysterious — but the actual root causes are limited and well-understood. In two years of marine installs we have not seen a problem that didn't trace back to one of four issues, and the diagnostic order to find them is the same every time.
This article is the field manual. It covers what obstruction errors actually mean, how to read the Starlink app correctly, the four root causes we encounter, and what to do about each. By the end you should be able to diagnose any Starlink issue on your boat to the right root cause without guessing.
"In two years of marine installs, every problem traces back to one of four issues. The diagnostic order is reliable."
What the obstruction map and statistics actually tell you.
The Starlink app is the diagnostic tool, and it is more informative than most owners realize. Three screens matter.
- Obstructions screen.Shows a heat map of the sky as the antenna sees it. Red areas are obstructed, green areas are clear. After 12 minutes of operation the map is meaningful; before that, ignore it.
- Statistics screen.Shows percentage of time obstructed and percentage of time idle over the last day. The relevant number is "obstructed time" — anything over 1 percent on a clean install is too much.
- Alerts and history.Logs of dropouts, obstruction warnings, and software updates. Read this for patterns — a dropout every 90 seconds is a different problem than a dropout once a week.
If your "obstructed time" reads under 1 percent and you are still seeing problems, the issue is not obstructions — it is one of the other three categories below. Don't waste time on the sky view if the sky view is fine.
The antenna can't see the sky it needs to see.
The most common root cause, and the one DIY installs hit most often. The antenna needs roughly 100 degrees of clear southern sky. If structure on the boat clips that cone, throughput drops and obstruction errors appear.
- Antenna under a hardtop edge.Mounted flush to a hardtop without a riser. The hardtop edge cuts into the sky cone. Fix: add a 12 to 24 inch riser, or relocate.
- Antenna behind a mast or radar dome.The mast clips part of the southern sky depending on boat heading. Fix: relocate the antenna to a position where mast and dome are not in the dominant sky cone.
- Antenna in a tower's shadow.Common on sportfish where the install put the antenna forward of a high tower top. Fix: move aft of the tower.
- Antenna correctly positioned, but boat now stored differently.Boat moved to a slip with new obstructions (a tall building, a hillside). Coverage map will reflect the new geometry.
For the deeper mount-selection logic, see our mount location guide. About 60 percent of "obstruction" calls trace back to this category.
Looks like coverage loss. Isn't.
The second-largest category of marine Starlink failures is cabling. Salt, vibration, and time defeat connectors that were correct at install. Symptoms look like coverage loss but trace to the cable plant.
- Corrosion at the antenna pigtail.The most common failure point. Green oxidation on the connector pins. Symptom: intermittent dropouts that worsen over months.
- Cable run too long or wrong type.Substituted cable that exceeds Starlink's spec degrades signal. The supplied cable is engineered for a specific run length — don't substitute.
- Damaged cable jacket.UV-degraded outer jacket exposes inner conductors. Marine pests (mice, squirrels in winter storage) chew cables. Symptom: progressive throughput loss.
- Cable gland not sealing.Water tracks down the cable into the boat. Symptom: corrosion at the indoor connector, sometimes only after the next rain.
The annual winterization step in our winterization article exists to catch these before they fail. About 25 percent of service calls trace here.
"60 percent mount, 25 percent cable, 10 percent power, 5 percent everything else. The percentages are stable."
The antenna brown-outs, and the symptoms look like coverage.
The third category is power. The Flat High Performance antenna pulls 110W at peak heater load. Undersized wiring or a marginal step-up converter can sag the supply voltage at peak, and the antenna behaves erratically.
- Undersized supply wiring.14 AWG to a 12V step-up handling 110W means voltage sag under load. Symptom: dropouts during cold-weather heater cycles or long active sessions. Fix: 10 AWG per ABYC E-11.
- Cheap step-up converter.Marginal regulators sag under peak load. Symptom: same as above, plus the converter runs hot. Fix: Victron, Mastervolt, or equivalent.
- House bank too low.Below 12V at the converter, the regulator gives up. Symptom: dropouts when the bank is depleted. Fix: charge the bank, or pause Starlink overnight on smaller systems.
- Inverter overload.If powered through an inverter, a marginal inverter can clip on Starlink peaks. Fix: DC-direct, per our DC wiring article.
About 10 percent of service calls trace here. The fix is correct wiring, every time.
The 5 percent that isn't a hardware problem.
The remaining 5 percent is software-side. Less common, but worth checking after the hardware diagnostics come up clean.
- Firmware update in progress.Antenna and router firmware updates take 5 to 30 minutes during which service is intermittent. Wait it out; check the app for update status.
- Service plan paused or expired.Owners returning to the boat in spring sometimes forget they paused. Check the Starlink dashboard.
- Wrong service plan for the use.Roam plan in deep offshore use, or a regionally locked plan. The dashboard will indicate it. See our Maritime vs. Roam guide.
- Account stolen or duplicated.Rare. Two devices on one account fight; the dashboard shows it. Contact Starlink support.
Check these last, after hardware-side causes are eliminated. They are rare but cheap to verify.
The 15-minute sequence that finds the problem.
Run these steps in order. The cause becomes obvious within the first three on most service calls.
- Open the Starlink app.Read the obstructions screen and statistics. Note the obstructed-time percentage.
- Visually inspect the antenna and its sky view.Stand under the antenna and look up. Is anything new in the southern sky cone — a temporary canvas, fishing rods, a recent boat-side modification?
- Check the indoor router status LED.Solid white means good. Blinking or color-shifted means cable, power, or firmware.
- Inspect the antenna cable termination at both ends.Pull, look for corrosion, reseat. Test again.
- Check the supply voltage at the antenna feed.If wired DC-direct, the converter output should read 48 to 56V under load. Sag means power.
- Check the Starlink account dashboard.Service plan active, hardware paired, no update pending.
- Reboot.Power-cycle antenna and router. Wait 5 minutes. Re-test.
- Call us.If steps 1 through 7 don't resolve the issue, it's a deeper diagnostic and we'll bring tools to the boat.
This sequence catches roughly 95 percent of the issues we see. The remaining 5 percent need a clamp meter, a TDR for the cable, or a closer look at the network integration — and at that point the right call is a service visit.
Most "Starlink doesn't work" calls trace to four causes. The diagnostic is fast.
Coverage almost never makes the list. The cause is mount, cable, power, or software — in roughly that order of frequency — and the diagnostic order finds it reliably. If your install was clean to start, the system runs reliably for years. If it wasn't, the symptoms surface predictably and the fixes are well-understood.
Service call? We diagnose installs we did not originally do, and the rate is the same as for our own work. Welcome aboard.