TLS certificates

Protect traffic to the application server.

Serve Daptin over TLS with configured certificate material or an ACME-backed certificate workflow.

Choose one termination boundary

BoundaryUse whenYou own
Reverse proxy/load balancerYour platform already manages certificates, HTTP policy, and rotation.Trusted proxy configuration, private upstream traffic, redirects, headers, renewal, and edge health.
Daptin HTTPS listenerDaptin directly serves a hostname and its enabled certificate.Certificate records/files, key protection, port exposure, SNI selection, renewal, and restart/reload behavior.

Do not terminate TLS at two unrelated public layers or expose a plaintext upstream on an untrusted network. Document which component redirects HTTP, owns HSTS/security headers, and renews each hostname.

Prepare names, DNS, ports, and keys

  1. List every public hostname and point DNS at the intended edge.
  2. Permit the validation and HTTPS ports required by the chosen certificate workflow.
  3. Issue a certificate whose subject alternative names cover the exact hosts.
  4. Store private keys with restrictive permissions and never commit them to the repository or image.
  5. Associate each Daptin-served site with the matching enabled certificate when Daptin terminates TLS.

Verify the client-visible result

openssl s_client -connect app.example.com:443 \
  -servername app.example.com -showcerts

curl --fail --show-error --head https://app.example.com/

Check the hostname, complete chain, issuer, validity window, negotiated protocol, redirect behavior, and the exact virtual host returned through SNI. Repeat for every hostname, including a host that should not match. Test from outside the deployment network.

Monitor renewal before expiry

Alert far enough before expiry to fix DNS, account, rate-limit, or permission failures. Exercise renewal in staging, verify that the serving process reloads the new certificate, and keep an operator procedure for emergency replacement and revocation.

TLS does not create application authorization. After transport is protected, still test authentication, record permissions, file access, site Basic Auth, and optional protocol access independently.

Choose where TLS terminates

Daptin termination

Configure the server to present certificates directly when it owns the public TLS endpoint.

ACME workflow

Use automated issuance and renewal where the environment can satisfy the required challenge.

Reverse proxy

Terminate at an intentional proxy or load balancer when that is the platform’s existing TLS setup.

Renewal monitoring

Alert before expiry and verify the full certificate chain from an external client.

Include transport security in deployment planning.