# Why Location Matters

Nexus Telemetry uses your dish’s location to display your terminal’s position, provide local weather data, match satellites in the Starlink Viewer (Pro), and record GPS routes during sessions (Pro). There are two ways to set your location: enabling GPS sharing on your Starlink dish, or setting it manually from an interactive map.

# Option 1: Enable GPS on Your Starlink Dish

Note: This option may no longer be available on newer hardware (V4, Mini) or recent versions of the Starlink app. If you don’t see the toggle in Step 4 below, use Option 2 instead.

If your Starlink dish has a built-in GPS receiver, you can share its location with Nexus Telemetry over your local network. By default, Starlink does not expose this data — you need to enable it in the Starlink mobile app.

Follow these steps in the official Starlink app (iOS or Android).

# Step 1: Open the Menu

Tap the hamburger menu (three horizontal lines) in the top-left corner of the main screen.

# Step 2: Open the Info Panel

Tap the info button (circled “i”) in the bottom-right corner of the account screen.

# Step 3: Open Debug Data

Scroll to the bottom of the info panel and tap the Debug data button.

# Step 4: Enable Location Sharing

Scroll down to the Starlink location section and enable the “Allow access on local network” toggle.

# What This Does

Enabling “Allow access on local network” tells your Starlink dish to include GPS coordinates in its local API responses. This data stays on your local network: it is only accessible to devices connected to your Starlink network, such as the computer running Nexus Telemetry.

Nexus Telemetry reads the coordinates from the dish’s local gRPC endpoint. No data is sent to Nexus Telemetry or any third party.

Once enabled, Nexus Telemetry will detect the GPS data automatically within a few seconds.

# Option 2: Set Your Location Manually

If GPS is unavailable on your dish — or if the location sharing option has been removed from the Starlink app — you can set your dish’s location manually using an interactive map.

Open the location modal by clicking the location prompt banner that appears on the location card, weather card, or Starlink Viewer (Pro). You can also open it at any time from the location card.

From the modal you can:

• Search for an address or place name
• Click the map to drop a pin at your dish’s position
• Review the latitude, longitude, and altitude before applying

Click Apply to save. Your coordinates are stored locally and persist between sessions — you only need to set them once. The manual location is used for weather data, and in Pro edition, for the Starlink Viewer and session route maps.

# What Becomes Available

Once your location is set — either via GPS or manually — you should see:

• Location card: Latitude and longitude coordinates with a mini map
• Weather card: Local weather conditions based on your dish’s position
• Starlink Viewer (Pro): Globe centred on your dish with satellite matching
• Session recording (Pro): Route mapping on recorded sessions

# Troubleshooting GPS

If GPS data does not appear in Nexus Telemetry after enabling the setting in the Starlink app:

1. Restart the Starlink app: Close and reopen the Starlink app, then verify the toggle is still enabled
2. Wait a moment: The dish may take up to a minute to acquire a GPS fix after a restart
3. Check the GPS source: In the Debug data screen, confirm the Source field shows “Automatic (GPS)” and that Latitude/Longitude values are displayed
4. Restart Nexus Telemetry: Close and reopen Nexus Telemetry to reset the connection to your dish
5. Check your network: Ensure Nexus Telemetry can reach your Starlink dish at 192.168.100.1 (see Connection Issues)

If GPS sharing is not available on your hardware or has been removed from the Starlink app, use the manual location option described above.

# A Note on Session Recording & GPS

Session route mapping currently relies on the dish’s GPS coordinates. We are actively working on USB GPS dongle support to enable route tracking independently of the dish’s built-in receiver. This will be particularly useful for mobile setups and hardware where Starlink has deprecated GPS access. Stay tuned for updates in a future release.