Turning Your Starlink Mini into a Real Telemetry Device - How to bridge Starlink Mini into MQTT and Node-RED for real-time monitoring and automation

 





If you’re running a remote station, digital voice system or any kind of modern connected ham infrastructure, your internet link is no longer “just internet” — it’s part of your station.

Starlink Mini gives you portable, high-availability connectivity, but out of the box it’s still a black box. You can see “online/offline,” but you can’t easily observe performance, uptime, obstruction trends or state changes in a way that integrates with the rest of your telemetry systems.

That’s exactly what the starlink-mini-mqtt-node-red-1 project solves.

This project creates a bridge between Starlink Mini, MQTT and Node-RED, allowing you to treat your satellite link like any other piece of instrumented infrastructure in your shack.

What It Does

The system polls Starlink Mini status data and publishes it into MQTT topics that can be consumed by:
- Node-RED
- Home Assistant
- Grafana
- InfluxDB
- Custom automation workflows

Once it’s in MQTT, it becomes part of your normal telemetry pipeline.

Typical MQTT Topics
starlink/mini/state  
starlink/mini/uptime_s  
starlink/mini/obstruction_percent  
starlink/mini/obstructed  
starlink/mini/software_version  
starlink/mini/raw_status  

The raw_status topic provides full JSON telemetry for deeper analysis, logging,and automation.

Deployment Philosophy

This project is designed to be simple, repeatable and infrastructure-friendly.

It’s Docker-first — simplifying installation and setup.

Basic deployment:

1) Create working directories

mkdir -p starlink-mini-mqtt/data starlink-mini-mqtt/cookie_cache
cd starlink-mini-mqtt

2) Export cookies from starlink.com

Log into https://www.starlink.com

Export cookies using a browser extension that can capture them in .json format like Cookies Extractor for Chrome.

Save as data/cookies.json

Example file is provided:

cp data/cookies.json.example data/cookies.json

3) Create docker-compose.yml

This example code assumes you already have an MQTT broker:

services:
  starlink-mini-mqtt-1:
    image: ghcr.io/n3bkv/starlink-mini-mqtt-1:latest
    container_name: starlink-mini-mqtt-1
    restart: unless-stopped
    volumes:
      - ./data:/data:ro
      - ./cookie_cache:/cookie_cache
    environment:
      STARLINK_MQTT_HOST: 192.168.1.10   # your broker
      STARLINK_MQTT_PORT: "1883"

4) Start the container

docker compose up -d
docker compose logs -f starlink-mini-mqtt-1

Once running, MQTT topics begin streaming immediately.

Why This Matters in Amateur Radio

Modern ham radio depends on IP infrastructure:
- Remote-controlled stations
- AllStar / EchoLink / VoIP linking
- Digital voice and data

Your internet connection is now a mission-critical subsystem.
This project makes it observable.

Instead of guessing:
- Is my link flaky?
- Is satellite obstruction increasing over time?
- Did the dish reboot?
- How often does my connection drop?

You can measure it.

Use Cases

- Alert when Starlink drops offline
- Track obstruction percent over time
- Correlate RF outages with IP outages
- Log uptime for reliability analysis
- Integrate connectivity into station dashboards
- Drive automation based on link state

Node-RED Sample Flow

Contained in the repository, is a sample Node-RED flow that will bring all of the data available into an easy to understand dashboard as shown above.

Important Note

This project uses unofficial Starlink APIs. Backend changes may break functionality and require updates. This is normal for any cloud-scraping integration and should be treated accordingly.

Wrap-Up

starlink-mini-mqtt-node-red provides a clean, extensible way to integrate Starlink Mini telemetry into MQTT-based workflows. For hams, makers and remote-station operators, it turns a black-box internet connection into an observable and automation friendly system.

Repository:
https://github.com/n3bkv/starlink-mini-mqtt-node-red-1









Comments

Popular posts from this blog

How To Get Precise Time Outside Your Shack

How To Set Up Your Own Remote Station

How to Put Your AllStar Node on 44Net Connect

Why You Might Want To Set Up Your Raspberry Pi Internet Web Server on 44Net

Building a Secure Web Portal on 44Net Without VPN Headaches

A Non-Programmers Guide on How To Use AI to Write Your Own Custom Ham Radio Computer Applications

Why You Should Use SSH Keys Instead of Passwords on Your Raspberry Pi

Internet Remote Software Defined Radio (SDR) Receivers – A Starter Guide

Wifi Network Clock Review: Great Features <$40 With A Security Concern

Automated Server Failover for Remote Stations

Ham RSS News Feeds

Amateur Radio Daily

ARRL News

Zero Retries