docs: Domain-Setup via API dokumentieren (domain.create + API-Key)

This commit is contained in:
Hermes
2026-08-12 20:42:36 +00:00
parent 6b06bc903b
commit 7eb062f356
+14 -1
View File
@@ -66,13 +66,26 @@ Docker-Service und stellt die Verbindungsdaten als Env-Variablen bereit.
Unter **Application → Domains**: Unter **Application → Domains**:
- **Host:** `techno-todo.192.168.0.184.sslip.io` - **Host:** `todo.kgessner.de` (öffentlich) oder `techno-todo.192.168.0.184.sslip.io` (LAN)
- **Port:** `3000` - **Port:** `3000`
- **HTTPS:** HTTP (für LAN-Test ausreichend) - **HTTPS:** HTTP (für LAN-Test ausreichend)
Dokploy erzeugt automatisch die Traefik-Routing-Konfiguration unter Dokploy erzeugt automatisch die Traefik-Routing-Konfiguration unter
`/etc/dokploy/traefik/dynamic/<app>.yml`. `/etc/dokploy/traefik/dynamic/<app>.yml`.
**Per API** (mit gültigem API-Key, Header `x-api-key`):
```bash
curl -X POST "https://dokploy.kgessner.de/api/domain.create" \
-H "x-api-key: $DOKPLOY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"host":"todo.kgessner.de","https":false,"port":3000,"applicationId":"<app-id>"}'
```
Der API-Key lässt sich über die Dokploy-UI (**Settings → API Keys**) erzeugen. Ist der
Key abgelaufen, kann man einen neuen direkt in der DB anlegen — der Hash ist
`base64url(SHA-256(key))` ohne Padding (BetterAuth-Mechanismus).
### 6. Auto-Deploy aktivieren ### 6. Auto-Deploy aktivieren
Dokploy hat einen nativen Auto-Deploy: In den **Application-Einstellungen** unter Dokploy hat einen nativen Auto-Deploy: In den **Application-Einstellungen** unter