Common issues

This page lists common problems and suggested fixes.

Agents not connecting

• Verify the control plane URL is reachable.
• Check firewall rules for WireGuard UDP traffic.
• Ensure join tokens are valid and not expired.

Relays unhealthy

• Confirm the relay is registered to the right region.
• Verify that the relay host has correct clock sync.

No traffic through tunnels

• Confirm access policies allow the traffic.
• Validate CIDR assignments and routes.