---
title: "Homarr Certificates — Trusted Certificate Management"
aliases: [homarr-tls, homarr-ssl, homarr-self-signed]
tags: [homarr, homelab, ssl, tls, self-signed, certificates]
sources: [raw/Homarr documentation 3.md]
created: 2026-04-19
updated: 2026-04-19
---

## Overview

Homarr's Certificates page lets you upload and manage trusted CA/self-signed certificates so that integrations using HTTPS with custom certificates work without errors. All certificates are stored in `/appdata/trusted-certificates`.

Navigate to: `Management` > `Tools` > `Certificates`

---

## Certificate Status Colors

| Color | Meaning |
|-------|---------|
| Green | Valid for more than 30 days |
| Yellow | Valid for less than 30 days |
| Orange | Valid for less than a week |
| Red | Valid for less than a day |

Each card shows: subject, filename, and expiry date.

---

## Adding a Certificate

1. Click **"Add certificate"** on the Certificates page.
2. Select the `.crt` / `.pem` file from your local machine.
3. Click **"Add"**.

---

## Deleting a Certificate

1. Click the trash icon on the certificate card.
2. Confirm deletion in the dialog.

---

## File System Access

Certificates live in `/appdata/trusted-certificates` (mounted via `/appdata`). You can automate certificate rotation by dropping files directly into that directory — no UI action needed.

```
/appdata/
└── trusted-certificates/
    ├── pihole-tls_ca.crt
    └── my-service.crt
```

---

## Obtaining Certificates per Integration

### Pi-hole v6

Pi-hole v6 enables HTTPS on its web interface by default. The CA cert is at:

```
/etc/pihole/tls_ca.crt
```

Copy this file to Homarr's trusted-certificates directory or upload it via the UI.

---

## Key Takeaways

- Homarr stores trusted certs in `/appdata/trusted-certificates` — automatable via filesystem.
- Color-coded expiry indicator: green → yellow → orange → red as expiry approaches.
- Upload via UI or drop files directly into the mounted directory.
- Pi-hole v6 cert path: `/etc/pihole/tls_ca.crt`.
- Each integration has its own cert location — check that integration's docs.

---

## Related

- [[wiki/homelab/homarr-api|Homarr API — Programmatic Dashboard Management]]
- [[wiki/homelab/homarr-apps|Homarr Apps — Managing Dashboard Links & Status Checks]]
- [[wiki/homelab/homarr-boards|Homarr Boards — Dashboard Management]]
- [[wiki/homelab/home-server-101|Home Server 101 — The Beginner's Guide to Self-Hosting]]

---

## Sources

- `raw/Homarr documentation 3.md` — Homarr v1.59.2 official docs, certificates page
