Certificates¶
Factum can request TLS certificates with lego using the DNS-01 challenge and RFC2136 dynamic updates.
Enable Certificates under Admin → Destinations. That shows the Certificates menu and includes certs in jobs.
What is stored¶
- Certificates — name and list of domains (SAN). Optional overrides for certificate key type and enable Common Name. Empty override uses Destinations → Certificates defaults.
- Accounts — ACME account (email, server URL, account key type, ToS, optional EAB).
- Challenges — DNS-01 / RFC2136: nameserver, TSIG key/secret/algorithm, resolvers, extra env vars.
Distribution of issued files and restarting services is out of scope.
factum2-certs only writes lego config and runs lego.
Sync¶
factum2-certs sync (worker role certs) fetches config from the primary,
writes:
.lego.yamlat lego YAML path.envat .env path (RFC2136 credentials and extra env)
then runs the lego binary in the YAML directory. Install lego on that host.
Worker commands example:
certs:
cmd: /opt/factum2/factum2-certs
args: ["sync", "--job"]