From f2dd63a73da0134f0bbea429fd73bd862141f11d Mon Sep 17 00:00:00 2001 From: Kris Anderson <1562427+kris-anderson@users.noreply.github.com> Date: Sun, 8 Nov 2026 15:46:03 -0800 Subject: [PATCH] add channels-dvr.subdomain.conf.sample Channels DVR treats any request carrying X-Forwarded-For as remote and answers with its authorization-code page, so the sample documents that and offers Channels' own X-DVR-SkipAuth header, commented out, for LAN-only swag installs. Co-Authored-By: Claude Opus 5.5 --- channels-dvr.subdomain.conf.sample | 63 ++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 channels-dvr.subdomain.conf.sample diff --git a/channels-dvr.subdomain.conf.sample b/channels-dvr.subdomain.conf.sample new file mode 100644 index 00000000..4ed680ea --- /dev/null +++ b/channels-dvr.subdomain.conf.sample @@ -0,0 +1,63 @@ +## Version 2026/11/08 +# make sure that your channels-dvr container is named channels-dvr +# make sure that your dns has a cname set for channels-dvr +# if channels-dvr is running in bridge mode and the container is named "channels-dvr", the below config should work as is +# if not, replace the line "set $upstream_app channels-dvr;" with "set $upstream_app ;" +# or "set $upstream_app ;" for host mode (the mode in the Channels DVR docker instructions), HOSTIP being the IP address of channels-dvr +# Channels DVR treats any request that carries an X-Forwarded-For header as coming from outside your home network, +# so through this proxy its web UI asks for an authorization code from your Channels account +# if swag is only reachable from your LAN, you can skip that prompt by uncommenting the X-DVR-SkipAuth line below +# do not uncomment it if swag is reachable from the internet: it turns off the authorization code check for every visitor + +server { + listen 443 ssl; +# listen 443 quic; + listen [::]:443 ssl; +# listen [::]:443 quic; + + server_name channels-dvr.*; + + include /config/nginx/ssl.conf; + + client_max_body_size 0; + + # enable for ldap auth (requires ldap-location.conf in the location block) + #include /config/nginx/ldap-server.conf; + + # enable for Authelia (requires authelia-location.conf in the location block) + #include /config/nginx/authelia-server.conf; + + # enable for Authentik (requires authentik-location.conf in the location block) + #include /config/nginx/authentik-server.conf; + + # enable for Tinyauth (requires tinyauth-location.conf in the location block) + #include /config/nginx/tinyauth-server.conf; + + location / { + # enable the next two lines for http auth + #auth_basic "Restricted"; + #auth_basic_user_file /config/nginx/.htpasswd; + + # enable for ldap auth (requires ldap-server.conf in the server block) + #include /config/nginx/ldap-location.conf; + + # enable for Authelia (requires authelia-server.conf in the server block) + #include /config/nginx/authelia-location.conf; + + # enable for Authentik (requires authentik-server.conf in the server block) + #include /config/nginx/authentik-location.conf; + + # enable for Tinyauth (requires tinyauth-server.conf in the server block) + #include /config/nginx/tinyauth-location.conf; + + include /config/nginx/proxy.conf; + include /config/nginx/resolver.conf; + set $upstream_app channels-dvr; + set $upstream_port 8089; + set $upstream_proto http; + proxy_pass $upstream_proto://$upstream_app:$upstream_port; + + # skip the authorization code prompt; only for a swag that is not reachable from the internet (see the top of this file) + #proxy_set_header X-DVR-SkipAuth true; + } +}