pub struct AcmeCfg {
pub enabled: bool,
pub domains: Vec<String>,
pub email: String,
pub directory_url: String,
pub cache_dir: String,
pub accept_tos: bool,
pub budget_enabled: bool,
}Expand description
Automatic certificate management (ACME / Let’s Encrypt) via the HTTP-01 challenge. The
obtained certificate is written to TlsCfg::cert_path/key_path and served by the TLS
listener. Issuance runs at startup only when no certificate exists at cert_path;
there is no automatic renewal yet (see docs/ROADMAP.md) — delete the cert/key files
and restart to re-issue.
Fields§
§enabled: boolObtain and renew a certificate automatically over ACME HTTP-01 instead of reading
cert_path/key_path from disk. Requires port 80 to be reachable from the CA.
domains: Vec<String>Domains to request a certificate for (the first is the primary CN).
email: StringContact email for the ACME account (registration + expiry notices).
directory_url: StringACME directory URL. Defaults to Let’s Encrypt staging so a misconfiguration can’t burn the strict production rate limits; switch to production explicitly.
cache_dir: StringDirectory for the cached ACME account key (so renewals reuse the same account).
accept_tos: boolYou must set this to true to signify acceptance of the ACME provider’s Terms of
Service; EdgeGuard refuses to register otherwise.
budget_enabled: boolRefuse to send an order the CA’s published rate limits would reject, instead of finding out
by being refused. On by default. See crate::acme_budget.
Only recognised CAs are budgeted — an unknown directory URL gets no profile and no guard, because holding a private CA to Let’s Encrypt’s numbers would refuse orders it would have accepted. Turn this off only if the budget is wrong about your CA and you would rather have the CA be the one that says no.
This governs this edge’s own ledger only. In managed mode the control plane still issues the fleet-wide issuance lease, because limits the CA applies across every edge under one registered domain are not this edge’s to opt out of — one box turning this off would otherwise be able to spend the whole fleet’s weekly allowance.