Skip to main content

Runbook: Network Issues

Purpose​

Restore network connectivity when services cannot reach each other or external clients cannot reach RavenmaskOS endpoints.

Symptoms​

  • Services return timeouts or connection refused
  • Inter-service calls fail
  • Public URLs not reachable

Prerequisites​

  • SSH access to odin
  • Access to DNS provider (Cloudflare)

Procedure​

Step 1: Check public DNS and TLS​

# DNS resolution
nslookup traefik.ravenhelm.dev

# TLS response
curl -I https://traefik.ravenhelm.dev

Step 2: Check Traefik routing​

ssh ravenhelm@100.115.101.81 "docker logs traefik --tail 200"
ssh ravenhelm@100.115.101.81 "docker ps | grep traefik"

Step 3: Validate Docker network​

ssh ravenhelm@100.115.101.81 "docker network inspect ravenhelm_net | head -60"

Step 4: Confirm service health​

ssh ravenhelm@100.115.101.81 "docker ps | grep <service>"
ssh ravenhelm@100.115.101.81 "docker logs <service> --tail 200"

Verification​

  • Public endpoint responds with HTTP 200/302 as expected
  • Service can reach required upstreams

Rollback​

Revert recent network-related changes (Traefik config, DNS records, firewall rules) and restart the affected containers.