NetBird — Runbook
Routine Tasks
Check container status
ssh [email protected] "docker ps"
Restart the stack
ssh [email protected] "cd /opt/homelab/netbird && docker compose restart"
Logs
| Log | Contents | Location | Loki query | Format |
|---|---|---|---|---|
| Dashboard | Web UI events | Docker (LXC 115) stdout | {job="netbird", container="netbird-dashboard"} |
Plain text |
| Management | Peer registration, auth, network config | Docker (LXC 115) stdout | {job="netbird", container="netbird-management"} |
Plain text |
| Signal | Peer signaling events | Docker (LXC 115) stdout | {job="netbird", container="netbird-signal"} |
Plain text |
| Relay | Traffic relay events | Docker (LXC 115) stdout | {job="netbird", container="netbird-relay"} |
Plain text |
| TURN (coturn) | TURN/STUN connection events | Docker (LXC 115) stdout | {job="netbird", container="netbird-coturn"} |
Plain text |
Notes:
- SSH fallback: ssh [email protected] "docker logs netbird-management" (or other container names)
Troubleshooting
Peers can't connect
- Check management logs:
{job="netbird", container="netbird-management"} |= "error" - Verify all containers are running:
ssh [email protected] "docker ps" - Check signal/relay logs for connection issues