Describe the error
When attempting to connect Ombi to Jellyfin using HTTPS with port 443 (instead of the default 8096), the connection fails. The documentation doesn't clearly explain how to configure the hostname/port when Jellyfin is accessed via HTTPS through a reverse proxy.
Location
https://docs.ombi.app/settings/jellyfin/
Specifically in the "Fields" section where it describes:
- "Hostname / IP" field
- "Port" field
- "SSL" field
Suggested correction
The documentation should clarify how to configure the connection when Jellyfin is behind a reverse proxy with SSL termination. Specifically:
-
In the "SSL" field description, it currently states:
- "If you have enabled SSL in Jellyfin, then turn this on."
- "If SSL is handled by a reverse proxy, leave it off."
However, it doesn't explain what hostname/port combination to use when SSL is handled by a reverse proxy.
-
Add clearer examples for common scenarios:
Scenario 1: Direct Jellyfin connection (no reverse proxy)
- Hostname:
192.168.1.100
- Port:
8096
- SSL: Off
Scenario 2: Jellyfin with built-in SSL
- Hostname:
192.168.1.100
- Port:
8096
- SSL: On
Scenario 3: Jellyfin behind reverse proxy (SSL termination)
- Hostname:
jellyfin (internal service name) OR 192.168.1.100
- Port:
8096
- SSL: Off
- Note: Use internal connection, not external HTTPS URL
Scenario 4: Connecting to external HTTPS endpoint
- Hostname:
jellyfin.example.com
- Port:
443
- SSL: On
- Clarify if this is supported or if internal connection is required
-
Clarify whether Ombi needs to connect to:
- The internal Jellyfin instance (container name/internal IP)
- The external HTTPS URL
- Or if both methods are supported
Screenshots
N/A
Method of access:
Additional context
This issue commonly occurs when Jellyfin is deployed behind a reverse proxy (like Traefik, Nginx, or Caddy) that handles SSL termination. Users naturally try to use the external HTTPS URL with port 443 and SSL enabled, but this may not be the correct configuration.
In containerized deployments (Docker/Docker Compose), it's unclear whether Ombi should connect using:
- Internal service names (e.g.,
jellyfin:8096 with SSL off)
- External domains (e.g.,
jellyfin.example.com:443 with SSL on)
The current documentation doesn't address this common deployment scenario adequately.
Describe the error
When attempting to connect Ombi to Jellyfin using HTTPS with port 443 (instead of the default 8096), the connection fails. The documentation doesn't clearly explain how to configure the hostname/port when Jellyfin is accessed via HTTPS through a reverse proxy.
Location
https://docs.ombi.app/settings/jellyfin/
Specifically in the "Fields" section where it describes:
Suggested correction
The documentation should clarify how to configure the connection when Jellyfin is behind a reverse proxy with SSL termination. Specifically:
In the "SSL" field description, it currently states:
However, it doesn't explain what hostname/port combination to use when SSL is handled by a reverse proxy.
Add clearer examples for common scenarios:
Scenario 1: Direct Jellyfin connection (no reverse proxy)
192.168.1.1008096Scenario 2: Jellyfin with built-in SSL
192.168.1.1008096Scenario 3: Jellyfin behind reverse proxy (SSL termination)
jellyfin(internal service name) OR192.168.1.1008096Scenario 4: Connecting to external HTTPS endpoint
jellyfin.example.com443Clarify whether Ombi needs to connect to:
Screenshots
N/A
Method of access:
Additional context
This issue commonly occurs when Jellyfin is deployed behind a reverse proxy (like Traefik, Nginx, or Caddy) that handles SSL termination. Users naturally try to use the external HTTPS URL with port 443 and SSL enabled, but this may not be the correct configuration.
In containerized deployments (Docker/Docker Compose), it's unclear whether Ombi should connect using:
jellyfin:8096with SSL off)jellyfin.example.com:443with SSL on)The current documentation doesn't address this common deployment scenario adequately.