# 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

1. Im IONOS-Konto den [Developer Hub](https://developer.hosting.ionos.com/docs/getstarted) öffnen und API-Zugang aktivieren.
2. Unter **API Keys** einen neuen Key anlegen.
3. **Public Prefix** und **Secret** kopieren. In der Plattform trägst du sie als `prefix.secret` ein (ein Punkt dazwischen).

Das ist die **Hosting-DNS-API** (`api.hosting.ionos.com`), nicht IONOS Cloud.

## 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, API-Zugang im IONOS-Konto aktivieren und die Anbindung aktualisieren.
- **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" >}})