Skip to content

OrOrbit is in pre-launch. Downloads, accounts, and sponsorship open at launch.

Connectivity & Troubleshooting

OrOrbit uses a 3-layer connectivity strategy that works automatically for most users. This page explains how it works and what to do if you hit issues.

How connections work

When your server starts, OrOrbit tries three approaches in order:

1

UPnP Auto-Forwarding

Best

OrOrbit asks your router to open the required ports automatically using UPnP. This is the same technology used by game consoles and media servers. Works on most home routers with UPnP enabled (the default on most routers).

Result: Full voice quality. Friends connect directly to your public IP. Zero configuration needed.

2

Tunnel + TURN Relay

Fallback

If UPnP isn't available (disabled router, double NAT, etc.), OrOrbit automatically starts a secure tunnel for chat and text. Voice uses a built-in TURN relay that only needs one port forwarded (UDP 3478).

Chat: Works immediately via tunnel — no setup needed.
Voice: Forward UDP port 3478 on your router for full voice quality.
3

Manual Port Forwarding

Manual

If you prefer manual control, you can forward these ports on your router:

Port Protocol Purpose
3000 TCP OrOrbit server (HTTP + WebSocket)
3478 UDP TURN relay (voice)
40000-40100 UDP Media (voice/video RTP)

Built-in diagnostics

OrOrbit includes a connectivity wizard that checks everything automatically. Go to Settings > Server and click "Check Connectivity" to see:

  • Chat: Can friends reach your server for text and messages?
  • Voice: Can the TURN relay accept voice connections?
  • LAN: Can devices on your local network connect directly?

Each check shows a green checkmark or yellow warning with specific suggestions for how to fix the issue.

Troubleshooting FAQ

Friends can chat but not voice call

Chat works through the tunnel, but voice needs UDP port 3478 forwarded. Open your router settings and forward UDP 3478 to your PC's local IP address.

UPnP is not available

Your router may have UPnP disabled. Check your router's admin page (usually 192.168.1.1) and look for a UPnP or "NAT-PMP" setting. Some ISP-provided routers don't support UPnP — in that case, use manual port forwarding.

Double NAT detected

If your network has two routers (e.g. ISP modem + your router), UPnP may only open ports on the inner router. Ask your ISP to put their modem in "bridge mode", or forward ports on both devices.

Server starts but friends can't connect

Make sure you're sharing the correct URL. If using a tunnel, share the tunnel URL (shown in Settings > Server). If using direct connection, share your public IP. The connectivity wizard will tell you exactly which URL to share.

Windows Firewall is blocking OrOrbit

The installer adds firewall rules automatically, but if you see a Windows Firewall prompt, click Allow access for both private and public networks.

Can I use a custom domain?

Yes! Point a DNS A record to your public IP address, then configure your server's URL in Settings. For HTTPS, place a reverse proxy (like Caddy or nginx) in front of OrOrbit.

Reporting issues

If something goes wrong, OrOrbit keeps a detailed error log you can send to help diagnose the problem.

  1. 1
    Open Settings (gear icon in the bottom-left corner).
  2. 2
    Click Error Log in the sidebar. If there are errors, you’ll see a red badge with the count.
  3. 3
    Click Copy All to copy the full log to your clipboard.
  4. 4
    Send it to the server owner. The log includes timestamps, error codes, and stack traces — everything needed to track down the problem.
Privacy: The error log stays on your device and is never sent anywhere automatically. Only you decide when to share it.
← Back to Setup Guide