# Domains

> Die Dokumentation unter einer eigenen Domain veröffentlichen – DNS einrichten, prüfen, als primär setzen.

Im Reiter **Domains** siehst du alle Adressen, unter denen deine Dokumentation erreichbar ist. Jede Website hat eine
**Subdomain** (`<workspace>.<domain der Installation>`) und kann beliebig viele **eigene Domains** bekommen.

Die **primäre** Domain wird für Links, Sitemap und Canonical-URLs verwendet.

## Eigene Domain verbinden

:::steps
### Domain eintragen

Unter **Eigene Domain verbinden** die **Domain** eingeben und **Hinzufügen** klicken. Am besten eignet sich eine
Subdomain wie `docs.example.com` oder `help.example.com`.

### DNS-Einträge anlegen

Docsello zeigt eine Tabelle mit **Typ**, **Name / Host** und **Wert**. Lege diese Einträge bei deinem
Domain-Anbieter an:

| Typ | Name / Host | Wert |
|---|---|---|
| `CNAME` | deine Domain, z. B. `docs.example.com` | die angezeigte Zieladresse |
| `TXT` | `_docsello.docs.example.com` | der angezeigte Prüfcode |

Der TXT-Eintrag beweist, dass dir die Domain gehört; der CNAME leitet die Besucher zu Docsello. Je nach Installation
genügt einer von beiden zur Prüfung – der Hinweis über der Tabelle sagt dir, was nötig ist.

### Prüfen

Auf **Prüfen** klicken. Sobald die Einträge gefunden werden, wechselt der Status von *DNS ausstehend* zu
*Verifiziert*. Das HTTPS-Zertifikat wird danach automatisch ausgestellt.
:::

:::info[Geduld bei DNS]
DNS-Änderungen brauchen meist wenige Minuten, selten bis zu 48 Stunden. Meldet die Prüfung *Noch nicht gefunden.*,
einfach später noch einmal **Prüfen**.
:::

## Root-Domain ohne Subdomain

Für eine Domain ohne Subdomain (z. B. `example.com`) erlauben die meisten DNS-Anbieter keinen CNAME. Nutze dann
ALIAS/ANAME bzw. „CNAME-Flattening“ deines Anbieters, oder verifiziere nur per TXT-Eintrag.

## Primäre Domain

Mit **Als primär setzen** machst du eine verifizierte Domain zur Hauptadresse. Links, Sitemap, Canonical-URLs und
`llms.txt` verwenden danach diese Domain. **Entfernen** trennt eine Domain wieder von der Website.

:::tip[Anmeldung über eigene Domains]
Nutzt du [Single Sign-on](doc:single-sign-on), trage beim Anmelde-Anbieter auch
`https://<eigene-domain>/auth/oidc/callback` als Redirect-URI ein.
:::

Betreibst du Docsello selbst, beachte zusätzlich [Mehrere Websites](doc:mehrere-websites) – dort steht, was auf dem
Server für neue Domains nötig ist.
