SolarNet API access - SolarNetwork/solarnetwork GitHub Wiki

SolarNetwork is managed and hosted by the non-profit charity SolarNetwork Foundation. The service aims to be free to use for non-commercial purposes. Funding is done via low-cost monthly subscriptions. If you'd like to support SolarNetwork, or wish to use the service for commercial purposes, please get in touch via email at [email protected].

SolarNetwork API service URLs

Service URL Description
SolarDIN https://din.solarnetwork.net Datum Input Endpoint API for non-native data ingestion.
SolarFlux WebSocket wss://flux.solarnetwork.net MQTT over WebSocket access to SolarNode data.
SolarFlux mqtts://fluxion.solarnetwork.net:8885 MQTT access to SolarNode data.
SolarFlux Input mqtts://influx.solarnetwork.net:8884 MQTT access for SolarNode <-> SolarFlux integration.
SolarIn https://in.solarnetwork.net/solarin HTTP access for SolarNode <-> SolarIn integration.
SolarIn MQTT mqtts://queue.solarnetwork.net:8883 MQTT access for SolarNode <-> SolarIn integration.
SolarQuery https://data.solarnetwork.net/solarquery API access to data posted by SolarNodes.
SolarQuery Proxy https://query.solarnetwork.net/solarquery Caching proxy API access to data posted by SolarNodes.
SolarSSH Client Direct ssh.solarnetwork.net:9022 Direct SSH client access for SolarSSH.
SolarSSH Client Websocket https://ssh.solarnetwork.net:8433 Websocket client access to SolarSSH.
SolarSSH Node ssh.solarnetwork.net:8022 SSH access for SolarNode <-> SolarSSH integration.
SolarUser https://data.solarnetwork.net/solaruser SolarNetwork account management, and API access for account management.

Site network firewall requirements for SolarNode

SolarNode never requires an inbound (internet to node) connection. The following outbound rules (node to internet) are used:

Port Destination Description
443 in.solarnetwork.net HTTP integration to SolarIn API
443 data.solarnetwork.net HTTP integration to SolarUser API
8022 ssh.solarnetwork.net SSH management connection to SolarSSH
8883 queue.solarnetwork.net MQTT integration to SolarIn. Required for real-time data collection and control, but can be disabled for HTTP-only batch-style integration (only recommended in specialized scenarios)
8884 influx.solarnetwork.net MQTT integration to SolarFlux. Required for SolarFlux integration only. If SolarFlux is not used, this port is not required.
⚠️ **GitHub.com Fallback** ⚠️