Fix Jellyfin Not Connecting: Connection Refused, Server Unreachable, and Network Issues (2026)

Fix Jellyfin Not Connecting: Connection Refused and Network Issues (2026)

You installed Jellyfin, it is running, but you cannot reach it from your browser, phone, or TV.

Quick Diagnosis

Fix 1: Jellyfin Is Not Running

# Docker
docker ps | grep jellyfin
docker logs jellyfin --tail 50

# Native Linux
sudo systemctl status jellyfin

Common startup failures:

• Port 8096 already in use
• Database migration error (10.11 upgrade)
• Missing config directory permissions

Fix 2: Firewall Blocking Port 8096

UFW (Ubuntu/Debian)

sudo ufw allow 8096/tcp
sudo ufw reload

firewalld (CentOS/Fedora)

sudo firewall-cmd --add-port=8096/tcp --permanent
sudo firewall-cmd --reload

Windows Firewall

1. Windows Defender Firewall, Advanced Settings
2. Inbound Rules, New Rule, Port, TCP 8096, Allow

Fix 3: Docker Network Mode Issues

# Wrong - no port mapping
services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    # Missing ports section!

# Fix Option 1: Map ports explicitly
ports:
  - "8096:8096"

# Fix Option 2: Use host networking (recommended on Linux)
network_mode: host

Fix 4: Port Conflict

sudo ss -tlnp | grep 8096

If Emby is running on 8096, change Jellyfin port:

ports:
  - "8097:8096"

Fix 5: Cannot Connect Remotely

Detect CGNAT

curl ifconfig.me
# Compare this IP with your router WAN IP
# If they differ you are behind CGNAT - port forwarding will not work

Fix 6: SSL Certificate Errors

Jellyfin built-in HTTPS uses a self-signed certificate. Browsers reject it.

Fix: Use a reverse proxy (Caddy, Nginx Proxy Manager) with a real Let Encrypt certificate.

# Check certificate expiry
echo | openssl s_client -connect jellyfin.yourdomain.com:443 2>/dev/null | openssl x509 -noout -dates

Fix 7: Reverse Proxy Not Forwarding Correctly

Caddy

jellyfin.yourdomain.com {
    reverse_proxy localhost:8096
}

Jellyfin 10.10.7+ Trusted Proxies

Dashboard, Networking, Known Proxies - add your reverse proxy IP address.

Connection Troubleshooting Flowchart

Can you reach http://localhost:8096 on the server?
  NO  → Jellyfin not running - check docker ps, systemctl status
  YES → Can you reach http://SERVER_IP:8096 from LAN?
          NO  → Firewall blocking port 8096
          YES → Can you reach from internet?
                  NO  → Port forwarding / CGNAT / DNS issue
                  YES → Working!

Server accessible? Monitor every connection from your phone. Download JellyWatch on Google Play - real-time session monitoring, device tracking, and push notifications for Jellyfin.