diff --git a/docs/tls.md b/docs/tls.md index 6e96f7613..f67a06d31 100644 --- a/docs/tls.md +++ b/docs/tls.md @@ -29,6 +29,20 @@ docker compose cp php:/data/caddy/pki/authorities/local/root.crt %TEMP%/root.crt +### Firefox + +Firefox uses its own trust store. Either import `root.crt` in +`Settings > Privacy & Security > View Certificates > Authorities`, +or set `security.enterprise_roots.enabled` to `true` in `about:config` +to make Firefox trust the authorities of the system trust store. + +The authority is regenerated when the `caddy_data` volume is removed +(e.g. with `docker compose down -v`). +The new authority has the same name as the previous one, +so if Firefox still trusts the old one, it shows `SEC_ERROR_BAD_SIGNATURE`. +Delete the `Caddy Local Authority` entry in the Authorities tab, +then trust the new `root.crt`. + ## Using Custom TLS Certificates By default, Caddy will automatically generate TLS certificates using Let's Encrypt