2026-03-30 22:31:06 +02:00
|
|
|
# Port Forwarding Guide
|
|
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
How to make your OwnCord server reachable from outside your LAN.
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
## Before You Start
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
If you want a simpler remote-access path, use [Tailscale](tailscale.md) and skip manual forwarding.
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
## Required Ports
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
### Always required
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
| Port | Protocol | Purpose |
|
|
|
|
|
| ---- | -------- | ------- |
|
|
|
|
|
| `8443` | TCP | OwnCord HTTPS + WebSocket |
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
### Required only for voice/video
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
| Port | Protocol | Purpose |
|
|
|
|
|
| ---- | -------- | ------- |
|
|
|
|
|
| `7880` | TCP | LiveKit signaling |
|
|
|
|
|
| `7881` | TCP | LiveKit TCP fallback |
|
|
|
|
|
| `50000-60000` | UDP | LiveKit media |
|
2026-03-30 22:31:06 +02:00
|
|
|
|
2026-04-03 23:18:06 +02:00
|
|
|
## Router Steps
|
|
|
|
|
|
|
|
|
|
1. Open your router admin page (often `192.168.1.1` or `192.168.0.1`).
|
|
|
|
|
2. Find the port forwarding section (sometimes called NAT, virtual server, or firewall rules).
|
|
|
|
|
3. Set static/reserved LAN IP for your server machine.
|
|
|
|
|
4. Add forwarding rule for `8443/TCP` to that LAN IP.
|
|
|
|
|
5. If using voice/video, add `7880/TCP`, `7881/TCP`, and `50000-60000/UDP`.
|
|
|
|
|
6. Save and apply rules.
|
|
|
|
|
|
|
|
|
|
## Connect Address to Share
|
|
|
|
|
|
|
|
|
|
Share `https://<your-public-ip>:8443` (or your DNS name) with users.
|
|
|
|
|
|
|
|
|
|
## Troubleshooting Checklist
|
|
|
|
|
|
|
|
|
|
- Confirm the server is listening on `8443`.
|
|
|
|
|
- Confirm router rules point to the correct LAN IP.
|
|
|
|
|
- Confirm OS firewall allows forwarded ports.
|
|
|
|
|
- Confirm ISP is not blocking inbound ports.
|
|
|
|
|
- Test from a different network (mobile hotspot), not from the same LAN.
|
|
|
|
|
|
|
|
|
|
## Dynamic Public IP
|
|
|
|
|
|
|
|
|
|
If your public IP changes, use dynamic DNS so users connect with a stable hostname.
|
