https://github.com/ledimestari/homeassistant-storj-integration
Add sensors to home assistant to monitor statistics of a storj node
https://github.com/ledimestari/homeassistant-storj-integration
hacs home-automation homeassistant homeassistant-custom-component homeassistant-integration storj storj-node
Last synced: 4 months ago
JSON representation
Add sensors to home assistant to monitor statistics of a storj node
- Host: GitHub
- URL: https://github.com/ledimestari/homeassistant-storj-integration
- Owner: ledimestari
- License: gpl-3.0
- Created: 2025-09-29T17:13:47.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-02-09T17:31:33.000Z (6 months ago)
- Last Synced: 2026-02-09T20:59:01.297Z (6 months ago)
- Topics: hacs, home-automation, homeassistant, homeassistant-custom-component, homeassistant-integration, storj, storj-node
- Language: Python
- Homepage:
- Size: 99.6 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Homeassistant Storj Node statistics
A custom homeassistant integration ```storj_node_statistics``` to read statistics from a storj storage node using json data provided by the node.
This integration is unofficial and not related to the official storj company at all.
## Example card
This is somewhat the view I'm using, the graphs should get more interesting over time.
## Setup
### HACS (recommended)
Click the button below to install via HACS.
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=ledimestari&repository=homeassistant-storj-integration&category=integration)
### Manual
Copy the "homeassistant_storj_integration" directory into the "custom_components" directory of your homeassistant install.
### Configuration
After installation, you'll be able to setup your device in the gui like this:
Setup is simple and only needs the IP-address (e.g. 192.168.1.123) and the port of your node server.
Default port 14002 provided as a default value.
## Features
This integration only reads data and does not not provide any actionable switches.
Provided sensors:
- Node ID
- Wallet address
- QUIC status
- Uptime
- Version number
- Diskspace Total
- Diskspace Used
- Diskspace Trash
- Diskspace Free
- Average Disk Space Used This Month
- Disk Use Percentage
- Bandwidth used this month
- Bandwidth Egress this month
- Bandwidth Ingress this month
- Estimated earning this month
- Held back this month
- Gross total this month
- Average online score of all satellites
each sensor uses the first six characters of the Node ID as a prefix to the key value, e.g. ```sensor.abc123_disk_use_percentage```.
Potential features missing for now:
- Suspension, Audit and Online scores for each satellite separate
- Total payout history
- Disk space overused
- Time since last contact
- Current period (Current month)
## Backend
This integration uses the api endpoints provided by your storj node, you can find the used json formatted data from the paths below.
Used api paths:
```
http://:14002/api/sno/
http://:14002/api/sno/estimated-payout
http://:14002/api/sno/satellites
```