# DNS mit Hostinger setzen

Einmal ein Hostinger-API-Token verbinden. MainPath schreibt A- und CNAME-Einträge in deine DNS-Zonen.

> Source: https://www.mainpath.ai/de/docs/dns-hostinger/

Wenn die DNS-Zone deiner Domain bei [Hostinger](https://www.hostinger.com/) liegt, musst du die Einträge nicht mehr von Hand abtippen. Du hinterlegst ein API-Token unter **Anbindungen**; sobald ein Projekt Domains hat, schreibt MainPath die Einträge in die passende Zone.

Manuelles DNS bleibt möglich. Siehe [DNS-Eintrag konfigurieren]({{< relref "domain-how-to" >}}).

## API-Token bei Hostinger

MainPath spricht die **Hostinger-DNS-API** (`developers.hostinger.com`) an. Die bestehende Hostinger-Anbindung unter **Server** wird **nicht** automatisch für DNS wiederverwendet. DNS bekommt eine eigene Kachel, auch wenn du denselben Token-Text dort einfügst.

1. Melde dich im [hPanel](https://hpanel.hostinger.com/) an und öffne **API** / Tokens.
2. Lege ein Token an, das Domains listen und DNS-Zonen verwalten darf.
3. Das Token kopieren. Es wird nur einmal angezeigt.

Die Domain muss Hostinger-Nameserver nutzen, zum Beispiel `ns1.dns-parking.com`, `ns1.ns.hostinger.com` oder `ns1.hostinger.com`.

## Anbindung in MainPath

1. Öffne **Anbindungen** und **Anbindung hinzufügen**.
2. Wähle unter **DNS** die Kachel **Hostinger DNS**.
3. Füge das API-Token ein und speichere. MainPath prüft, ob das Token gültig ist und welche Zonen es sieht.

Mehrere Hostinger-DNS-Zugänge in einer Organisation sind möglich. Gehört eine Domain zu mehreren Zonen, nimmt MainPath die treffendste.

## Was gesetzt wird

MainPath übernimmt dieselben Hosts, die du unter **Domains** siehst.

- Einträge werden nur gesetzt, wenn schon eine echte Server-Adresse da ist.
- Bestehende Einträge desselben Namens und Typs werden aktualisiert, nicht die ganze Zone ersetzt.
- Änderungen kommen schnell an.

```mermaid
flowchart LR
  org["Hostinger-DNS-Anbindung"]
  domains["Domains in MainPath"]
  zone["Hostinger-Zone"]
  server["Dein Server"]
  org --> zone
  domains -->|"A / CNAME"| zone
  zone --> server
```

Nach dem Speichern eines Projekts versucht MainPath, fehlende oder abweichende Einträge anzugleichen. Den Prüfstatus siehst du in der Domain-Übersicht.

## SSL über DNS-01 (optional)

Erreicht Let's Encrypt den Server nicht (kein öffentliches HTTP/443, Firewall, interne IP), öffne die Details dieser Anbindung und hake die betroffenen Domains an. MainPath schreibt dann den TXT-Eintrag `_acme-challenge` in diese Zone. Ohne Haken bleibt die bisherige TLS-Prüfung (ALPN) über den Server.

## Fehlersuche

- **Token ungültig**: Ein Hostinger-API-Token mit DNS-Rechten anlegen. Ein Token, das nur VPS verwalten kann, reicht nicht.
- **Kein Eintrag bei Hostinger**: Die Domain liegt in keinem Konto, das dieses Token sieht. Domainnamen prüfen.
- **Zone sichtbar, Domain nicht erreichbar**: Die Zone existiert bei Hostinger, aber die Nameserver der Domain zeigen woanders hin. Nameserver beim Registrar auf Hostinger (`*.dns-parking.com` / `*.ns.hostinger.com`) umstellen.
- **Status in MainPath noch rot**: DNS braucht oft ein paar Minuten, oder der Server hat noch keine bekannte Adresse.

## Siehe auch

- [Domain-Setup]({{< relref "domain" >}})
- [DNS-Eintrag konfigurieren]({{< relref "domain-how-to" >}})
- [Anbindungen]({{< relref "connections" >}})
- [Hostinger]({{< relref "hostinger-tutorial" >}})