Homarr
Manage trusted certificates

Inspect a named custom root CA certificate

GET/api/certificates/{fileName}

Return public metadata or null when absent. Requires admin permission. Does not return PEM contents.

Authorization

apikey
ApiKey<token>

API key which can be obtained in the Homarr administration dashboard

In: header

Path Parameters

fileName*string
Match^[a-zA-Z0-9][a-zA-Z0-9._-]*\.(crt|pem)$
Lengthlength <= 128

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/certificates/string"
{  "fileName": "string",  "sha256": "string",  "fingerprint256": "string",  "ca": true,  "validFrom": "string",  "validTo": "string"}

Change the first day of the week

Set a user's preferred first day of the week. Users can update themselves; updating another user requires admin permission.

Ensure a named custom root CA certificate without overwriting

Accept one currently valid self-signed PEM root CA (64 KiB maximum). Identical bytes are idempotent; different existing bytes return CONFLICT. Requires admin permission.