Administration
Register and troubleshoot a node
Connect rnode to control and diagnose common registration failures.
- For
- Administrators
- Updated
- August 11, 2026
Register the node
- 1Confirm rnode is running and control can reach its TCP API port.
- 2Open Admin, then Nodes, then Register node.
- 3Enter a clear name, the node base URL, /api/v1, and the rnode basic-auth credentials.
- 4Enable Edge node only when this node should handle browser fallback transfers.
- 5Save the registration, run Check connectivity, and review the advertised transfer host and available UDP ports.
- 6Assign Default storage only after connectivity succeeds.
Common failures
| Symptom | Check |
|---|---|
| Connection refused | Node host, API port, rnode service state, and TCP firewall rules |
| 401 or 403 | RNODE_AUTH_USER and RNODE_AUTH_PASS, then restart rnode after changes |
| TLS validation error | Certificate trust and a SAN matching the registered hostname or IP |
| Connectivity passes, transfer fails | RNODE_ADVERTISE_HOST routing and UDP transfer ports from the Desktop workstation |
| Capacity reached | Decommission or delete an unused node, or raise the configured entitlement |