Keep PFX copies current as your PEM certificates renew, and turn PFX bundles back into PEM
10K+
cert-converter keeps PFX copies of your certificates current as they renew, for apps that accept only PFX. It does not request certificates, and it does not restart the app that reads the PFX file.
cert-converter updates the PFX file your app reads each time its certificate renews.
<name>.crt and <name>.key pair, with its issuing certificates and an RSA, ECDSA, Ed25519 or ML-DSA key..pfx and .p12 bundles into PEM files, or write PEM copies beside the PFX files.PFX_ENCODER.cert-converter is built for people whose app takes only PFX, as some .NET apps, Windows tools and Synology services do. Their reverse proxy or certificate tool renews certificates as files. It reads <name>.crt and <name>.key pairs, as Caddy saves them, not Certbot's fullchain.pem and privkey.pem. It runs no command after a write, so your app must reread the PFX file or restart to use a renewed certificate.
You need Docker on amd64 or arm64, with the certificate files readable by the container's user.
Consider acme.sh if you want your certificate tool to write the PFX itself. Its --to-pkcs12 command exports a certificate and key to a PFX file, and --password protects it.
cert-converter is free software under the GPL-3.0-or-later license.
docker pull cplieger/cert-converter:latest
Also published to ghcr.io/cplieger/cert-converter with identical images and tags. Release versions are tagged vX.Y.Z alongside latest.
# Example compose for cert-converter. See the README for all configuration options and hardening.
services:
cert-converter:
image: ghcr.io/cplieger/cert-converter:latest
container_name: cert-converter
restart: unless-stopped
# In .env, set PUID and PGID to the user and group that own the certificate files.
# Create the output folder and run "sudo chown 1000:1000" on it, with those numbers, before the first start.
user: "${PUID:-1000}:${PGID:-1000}"
environment:
# Put PFX_PASSWORD=<a password> in .env. The container does not start without one.
# docker inspect shows this value. See README "Security" to use a secret file instead.
PFX_PASSWORD: "${PFX_PASSWORD:-}"
# When a certificate is gone, warn logs its converted files, sync deletes them, and keep leaves them without a log line.
# Use sync only once /input holds every certificate you want converted.
OUTPUT_LIFECYCLE: "${OUTPUT_LIFECYCLE:-warn}"
PFX_ENCODER: "modern2023" # modern2023, modern2026, legacy, or legacyrc2
volumes:
# The user above must be able to read this folder. See README "Quick start".
- "/path/to/certificates:/input:ro"
- "/path/to/converted/output:/output"
GPL-3.0-or-later. See LICENSE. The image carries the license text of every bundled component under /usr/share/licenses/.
Content type
Image
Digest
sha256:3ccd053f5…
Size
4.2 MB
Last updated
3 days ago
docker pull cplieger/cert-converter