Skip to content

docs: correct nginx X-Forwarded-Proto and certbot instructions flavor - #28086

Draft
nickvigilante wants to merge 1 commit into
mainfrom
vigilante/docs-642-docs-fix-reverse-proxy-nginx-x-forwarded-proto-scheme
Draft

docs: correct nginx X-Forwarded-Proto and certbot instructions flavor#28086
nickvigilante wants to merge 1 commit into
mainfrom
vigilante/docs-642-docs-fix-reverse-proxy-nginx-x-forwarded-proto-scheme

Conversation

@nickvigilante

Copy link
Copy Markdown
Contributor

What

Two fixes to the nginx reverse-proxy tutorial.

X-Forwarded-Proto (line 137)

The config set:

proxy_set_header X-Forwarded-Proto $http_x_forwarded_proto;

$http_x_forwarded_proto is the value of a client-supplied request header, which a client can spoof and which is usually empty for a direct request. In an nginx TLS-terminating reverse proxy this should be $scheme, which nginx sets from the actual connection (https). Using the raw client header can break Coder's scheme detection and secure-cookie handling.

Certbot link flavor (line 57)

The Certbot instructions link used ?ws=apache in an nginx guide; changed to ?ws=nginx so readers get nginx instructions.

Surfaced by the runtime drift sweep; verified against main.

Linear: DOCS-642

This PR was created with AI assistance (Coder Agents).

reverse-proxy-nginx.md set X-Forwarded-Proto from $http_x_forwarded_proto, a client-controlled (spoofable) header. In an nginx TLS-terminating reverse proxy it should be $scheme, which nginx derives from the actual connection. Also point the Certbot instructions link at the nginx flavor (ws=nginx) instead of apache. Fixes DOCS-642.

> This PR was created with AI assistance (Coder Agents).
@linear-code

linear-code Bot commented Aug 12, 2026

Copy link
Copy Markdown

DOCS-642

@github-actions

Copy link
Copy Markdown

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant