> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hocdoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eigene Domain

> Angebote unter deiner eigenen Adresse ausliefern: einrichten, Status verstehen, entfernen.

Mit einer eigenen Domain laufen deine Angebote unter deiner Adresse, zum Beispiel `angebote.deine-firma.de`, statt unter `app.hocdoc.com`. Die Einstellung findest du in den [Einstellungen](/guides/einstellungen) im Reiter „Domain“.

## Voraussetzungen

* Du bist Inhaber oder Admin des Workspace. Mitglieder und Betrachter sehen Domain und Status, haben aber keine Knöpfe.
* Du hast Zugriff auf den DNS-Anbieter der Domain, denn dort trägst du einen Eintrag ein.
* Du nutzt eine Subdomain, zum Beispiel `angebote.deine-firma.de`. Die Hauptdomain selbst geht noch nicht.

Jeder Workspace hat höchstens eine Domain.

## Einrichten

<Steps>
  <Step title="Reiter öffnen">
    Wähle „Einstellungen“ und dann den Reiter „Domain“. Die Karte heißt „Eigene Domain“.
  </Step>

  <Step title="Domain eintragen">
    Trag im Feld **Domain** deine Subdomain ein, zum Beispiel `angebote.deine-firma.de`, und wähle **Domain eintragen**.
  </Step>

  <Step title="CNAME setzen">
    Die Karte zeigt unter „DNS-Einträge“ eine Tabelle mit „Typ“, „Name“ und „Wert“. Mit **Kopieren** übernimmst du einen Wert. Lege diesen CNAME-Eintrag bei deinem DNS-Anbieter an. Bis er überall sichtbar ist, kann es einige Stunden dauern.
  </Step>

  <Step title="Erneut prüfen">
    Wähle **Erneut prüfen**. Neben dem Knopf steht, wann zuletzt geprüft wurde („Zuletzt geprüft: …“). Wiederhole die Prüfung, bis der Status „Aktiv“ zeigt.
  </Step>
</Steps>

Die Tabelle zeigt den Wert des CNAME. Übernimm ihn von dort. Liegen die Einträge noch nicht vor, steht dort: „Die DNS-Einträge liegen noch nicht vor. Prüfe gleich noch einmal.“

## Die Status

| Status | Bedeutung |
| - | - |
| „Wartet auf DNS“ | „Trage den CNAME-Eintrag bei deinem DNS-Anbieter ein. Bis er überall sichtbar ist, kann es einige Stunden dauern.“ |
| „Nachweis nötig“ | Die Domain hängt bei unserem Hosting-Anbieter schon an einem anderen Konto. Du trägst zusätzlich den angezeigten TXT-Eintrag ein, damit du nachweist, dass sie dir gehört. Bis dahin bleibt sie inaktiv. |
| „Wird geprüft“ | Eine Prüfung läuft gerade. |
| „Aktiv“ | „Neue Angebotslinks nutzen diese Domain. Links unter app.hocdoc.com funktionieren weiter.“ |
| „Fehler“ | Die Domain wurde abgelehnt. Unter dem Status steht der Grund (siehe [Häufige Fehler](#häufige-fehler)). |

Beim Öffnen des Reiters prüft die App den Stand von sich aus, wenn die letzte Prüfung länger zurückliegt. Mit **Erneut prüfen** löst du die Prüfung selbst aus. Lässt sich der Status nicht prüfen, meldet die App „Status konnte nicht geprüft werden“ und zeigt den gespeicherten Stand. Versuch es dann in ein paar Minuten noch einmal.

## Was sich mit aktiver Domain ändert

Neue Angebotslinks nutzen die eigene Domain:

* in den Mails an Empfänger,
* beim Kopieren des öffentlichen Links auf der Detailseite,
* für den Link zur Kurzfassung.

Bereits versendete Links unter `app.hocdoc.com` bleiben gültig.

Einiges bleibt auf der Hauptdomain: die Prüfseite aus dem Zertifikat, Links ins Dashboard, das Logo in Mails und die Anmelde-Mails.

## Was unter der Domain erreichbar ist

Unter deiner Domain sind nur die Angebotsseiten deines Workspace erreichbar. Die App selbst (Anmeldung, Dashboard) gibt es dort nicht. Ruft jemand einen Link auf, der zu einem anderen Workspace gehört oder nicht existiert, sieht er „nicht gefunden“.

## Domain entfernen

Wähle **Entfernen** und bestätige die Frage „Domain entfernen?“ mit **Entfernen**. Die Folgen:

* Angebote sind danach nur noch unter `app.hocdoc.com` erreichbar.
* Links in bereits versendeten Mails, die auf deine Domain zeigen, funktionieren nicht mehr.
* Entferne danach auch den CNAME-Eintrag bei deinem DNS-Anbieter.

Eine Domain, die einmal aktiv war, bleibt nach dem Entfernen 30 Tage für andere Workspaces gesperrt. Du selbst kannst sie sofort wieder eintragen.

Hat dein Workspace schon eine Domain, kannst du keine zweite eintragen: „Dieser Workspace hat schon eine Domain. Entferne sie zuerst.“ Wechseln heißt also erst entfernen, dann neu eintragen.

## Häufige Fehler

Meldungen beim Eintragen:

| Meldung | Was zu tun ist |
| - | - |
| „Das ist keine gültige Domain.“ | Schreibweise prüfen. |
| „Bitte trage eine Subdomain ein, zum Beispiel angebote.deine-firma.de.“ | Statt der Hauptdomain eine Subdomain eintragen. |
| „Diese Domain ist bereits vergeben.“ | Ein anderer Workspace nutzt die Domain oder hat sie gesperrt. Nimm eine andere Subdomain. |
| „Diese Domain kann nicht verwendet werden.“ | Die Domain ist gesperrt. Nimm eine andere. |
| „Nur Inhaber und Admins können die Domain verwalten.“ | Bitte einen Inhaber oder Admin. |
| „Zu viele Versuche. Versuch es später noch einmal.“ | Kurz warten. |
| „Die Einrichtung ist gerade nicht erreichbar. Versuch es später noch einmal.“ | Später noch einmal versuchen. |

Gründe im Status „Fehler“:

| Grund | Was zu tun ist |
| - | - |
| „Die Domain ist bei unserem Hosting-Anbieter bereits einem anderen Projekt zugeordnet.“ | Entfernen und eine andere Subdomain eintragen. |
| „Die Domain gehört einem anderen Konto bei unserem Hosting-Anbieter und lässt sich so nicht übernehmen.“ | Entfernen und eine andere Subdomain eintragen. |
| „Der Hosting-Anbieter hat die Domain abgelehnt. Prüfe die Schreibweise.“ | Schreibweise prüfen, entfernen, neu eintragen. |
| „Das ist eine Hauptdomain. Trage eine Subdomain ein, zum Beispiel angebote.“ plus deine Domain | Eine Subdomain eintragen. |
| „Diese Domain kann nicht verwendet werden. Entferne sie und trage eine andere ein.“ | Entfernen und eine andere Domain eintragen. |
| „Die Domain konnte nicht eingerichtet werden.“ | Entfernen und noch einmal eintragen. |

Bleibt der Status „Wartet auf DNS“, prüf den CNAME bei deinem DNS-Anbieter: Name und Wert müssen genau mit der Tabelle übereinstimmen. Zeigt der Status „Nachweis nötig“, fehlt der TXT-Eintrag.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.