2025.4.2
Home ▸ Integrations ▸

Starlink

The Starlink integration allows you to integrate your Starlink into Home Assistant.

Important: If your Starlink is in bypass mode, you will need to open a route to it so that the local API can be accessed. Otherwise this integration will not work.

Configuration

To add the Starlink integration to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & Services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Starlink.

  • Follow the instructions on screen to complete the setup.

Sensors

  • Ping - The ping that Starlink has measured, in ms
  • Ping drop rate - The percentage of failed ping requests (aka “dropped”). This is the inverse of “Uptime” in the Starlink app.
  • Azimuth - The direction Dishy is facing in degrees
  • Elevation - Dishy’s current elevation in degrees
  • Uplink throughput - The amount of data being uploaded through Starlink
  • Downlink throughput - The amount of data being downloaded through Starlink
  • Last boot time - The time Starlink was last turned on
  • Upload - Total number of bytes uploaded from the user terminal since reboot
  • Download - Total number of bytes downloaded to the user terminal since reboot
  • Power - Last measured power, in W
  • Energy - Measured energy consumption since reboot, in kWh

Binary sensors

  • Connected - Whether Starlink is connected to the Internet
  • Update available - Whether there is an update pending install
  • Roaming mode - Whether Starlink is “roaming”. Roaming is an optional upgrade that allows you to use your Starlink outside of your home address (also known as “portability mode”)

Diagnostic sensors

  • Obstructed - Whether Dishy is currently obstructed
  • Heating - Whether Dishy is currently heating. This may be due to cold temperatures, or an attempt to thaw snow and ice
  • Sleep - Whether Starlink is “sleeping”, as per the schedule defined in the Starlink app
  • Mast near vertical - Whether Dishy is mounted straight
  • Motors stuck - Whether Dishy is unable to move
  • Slow ethernet - Whether the Ethernet link is at max (gigabit) speed
  • Thermal throttle - Whether Starlink has reduced performance to avoid overheating
  • Unexpected location - Whether Starlink has detected operation outside of its designated area

Buttons

  • Reboot - Reboots your Starlink system

Switches

  • Stowed - Controls whether Dishy is stowed
  • Sleep schedule - Controls whether Starlink will enter a power-saving sleep mode at a predefined schedule

Device trackers

  • Device location - Tracks the latitude, longitude, and altitude of Dishy. You need to allow location access on the local network via the Starlink app for this to work. This is disabled by default in the Starlink app and is thus disabled by default in Home Assistant.

Times

  • Sleep start - The time at which Starlink will enter sleep mode, if “Sleep Schedule” is enabled
  • Sleep end - The time at which Starlink will exit sleep mode, if “Sleep Schedule” is enabled