# DNS mit IONOS setzen

Einmal den IONOS-API-Key verbinden – die Plattform schreibt A- und CNAME-Einträge in deine Zone.

> Source: https://www.application-platform.com/de/docs/dns-ionos/

Wenn deine Domain bei [IONOS](https://www.ionos.de/) liegt, musst du die Einträge nicht mehr von Hand abtippen. Du hinterlegst einen API-Key unter **Anbindungen**; sobald ein Projekt Domains hat, schreibt die Plattform die Einträge in die passende Zone.

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

## API-Key in IONOS

Das ist die **Hosting-DNS-API** (`api.hosting.ionos.com`), nicht IONOS Cloud und nicht der Data Center Designer. Ein Cloud-Token aus dem DCD funktioniert hier nicht.

1. Im IONOS-Konto anmelden (Kundennummer, E-Mail oder Domain).
2. Den [Developer Hub](https://developer.hosting.ionos.de/docs/getstarted) öffnen und den **API-Zugang** einmalig aktivieren (AGB akzeptieren).
3. Unter [API Keys](https://developer.hosting.ionos.de/keys) einen neuen Key anlegen.
4. **Public Prefix** und **Secret** kopieren. Die Plattform erwartet **eine** Zeile im Format `prefix.secret` (ein Punkt dazwischen). IONOS zeigt die beiden Teile oft getrennt; nicht mit Leerzeichen oder Zeilenumbruch einfügen.

Ohne aktivierten API-Zugang lehnt IONOS den Key ab, auch wenn Prefix und Secret korrekt aussehen.

## Anbindung in der Plattform

1. Öffne **Anbindungen** und **Anbindung hinzufügen**.
2. Wähle unter **DNS** die Kachel **IONOS**.
3. Füge den API-Key ein und speichere. Die Plattform prüft, ob der Key gültig ist und welche Zonen er sieht.

Mehrere IONOS-Zugänge in einer Organisation sind möglich. Gehört eine Domain zu mehreren Zonen, nimmt die Plattform die treffendste (zum Beispiel `shop.example.com` vor `example.com`).

## Was gesetzt wird

Die Plattform ü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 Typs werden aktualisiert, nicht die ganze Zone ersetzt.
- Änderungen kommen schnell an.

```mermaid
flowchart LR
  org["IONOS-Anbindung"]
  domains["Domains in der Plattform"]
  zone["IONOS-Zone"]
  server["Dein Server"]
  org --> zone
  domains -->|"A / CNAME"| zone
  zone --> server
```

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

## Fehlersuche

- **Key ungültig**: Format `prefix.secret` prüfen (ein Punkt, keine Leerzeichen), API-Zugang im IONOS-Konto aktivieren und die Anbindung aktualisieren. Ein Token aus IONOS Cloud / DCD ist der falsche Typ.
- **Kein Eintrag in IONOS**: Die Domain liegt in keiner Zone, die der Key sieht – Account oder Zonennamen prüfen.
- **Status in der Plattform 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" >}})
- [DNS mit Cloudflare setzen]({{< relref "dns-cloudflare" >}})