Skip to content

docs(load_balancer_service): document TLS termination and passthrough#1479

Open
nikolauspschuetz wants to merge 1 commit into
hetznercloud:mainfrom
nikolauspschuetz:docs/lb-service-tls-passthrough-1051
Open

docs(load_balancer_service): document TLS termination and passthrough#1479
nikolauspschuetz wants to merge 1 commit into
hetznercloud:mainfrom
nikolauspschuetz:docs/lb-service-tls-passthrough-1051

Conversation

@nikolauspschuetz

Copy link
Copy Markdown

Closes #1051.

Per @jooola on the issue — the Hetzner Cloud API has no dedicated "TLS passthrough" feature; the equivalent is achieved by choosing the service protocol, and the request was to document both configurations with examples.

This adds a "TLS Termination and Passthrough" section to the hcloud_load_balancer_service docs:

  • TLS terminationprotocol = "https" + certificates (LB terminates TLS, HTTP features available).
  • TLS passthroughprotocol = "tcp" forwarding port 443 (LB forwards the raw TCP/TLS stream; targets terminate TLS).

Docs-only: edited the template templates/resources/load_balancer_service.md.tmpl and regenerated docs/resources/load_balancer_service.md via make generate (Terraform v1.15.7). No code or schema changes.

AI assistance

Drafted with Claude Code; I directed the content, confirmed the protocol semantics against the existing docs, and verified the regenerated output. make generate touched only the intended files.

The Hetzner Cloud API has no dedicated "TLS passthrough" toggle; whether the
Load Balancer terminates TLS or passes it through to the targets is determined
by the service `protocol`. Document both configurations with examples, as
requested in hetznercloud#1051 (`protocol = "https"` + certificates for termination,
`protocol = "tcp"` for passthrough).

Closes hetznercloud#1051

Assisted-by: Claude Code (Anthropic, Opus 4.x)
@nikolauspschuetz nikolauspschuetz requested a review from a team as a code owner July 8, 2026 03:58
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.

[Bug]: No option for TLS Passthrough for hcloud_load_balancer_service

1 participant