X.509 Certificates

An X.509 certificate stores a single PEM-encoded certificate. Unlike a TLS bundle, it does not include a private key or a CA certificate -- it holds one certificate file only.

Updated 16 Jul 20262 min read

An X.509 certificate stores a single PEM-encoded certificate. Unlike a TLS bundle, it does not include a private key or a CA certificate -- it holds one certificate file only.

When to use an X.509 certificate

  • Your application needs to trust an intermediate CA or cross-signed certificate
  • You distribute a signing certificate that other services validate against
  • A third-party integration requires you to supply a client certificate separately from the key
  • You need to pin a specific certificate for verification purposes

What Bahriya extracts

When you upload an X.509 certificate, Bahriya parses it and stores metadata alongside the encrypted material:

FieldDescription
SubjectThe entity the certificate identifies (e.g. CN=signing.example.com)
IssuerThe CA that signed the certificate
FingerprintSHA256 fingerprint for verification
AlgorithmKey algorithm (RSA, EC, etc.) and key size
ExpiresCertificate expiry date, shown as a countdown badge in the console

This metadata is visible in list views and detail pages so you can spot expiring certificates at a glance.

Mounting in containers

When you attach an X.509 certificate to a container, the mount path you choose is the exact file the certificate is delivered as -- not a directory. Enter the full file path your application expects:

/etc/certs/upstream.pem    # the mount path IS the file

The file is placed at exactly that path and sits alongside the other files already in that directory -- it does not replace or hide them.

Rotation

Rotation creates a new version of the certificate. The previous version is retained for rollback. After rotation:

  • Because the certificate is mounted as a single exact file, the running container does not pick up the new version automatically. Use the Redeploy button on the Consumers panel to roll the container onto the rotated version.

Pricing

X.509 certificates are billed at $0.02 per month while they exist, plus $0.02 per region per month when attached to a project.

See also