Custom Domains

Jede Anwendung kann unter einer oder mehreren Domains erreichbar sein. TLS-Zertifikate werden automatisch über Let’s Encrypt ausgestellt.

Subdomains unter btc-ag.cloud

Für Subdomains unter *.btc-ag.cloud ist kein DNS-Aufwand auf eurer Seite nötig — das Platform-Team richtet die nötigen DNS-Einträge ein.

Teilt dem Platform-Team mit:

Gewünschte Subdomain (z. B. meine-app.btc-ag.cloud)
Zugehörige Anwendung auf der Plattform

Sobald der DNS-Eintrag gesetzt ist, genügt es, die Domain in der Anwendungskonfiguration einzutragen.

Eigene externe Domain

Wenn ihr eine eigene Domain (z. B. app.meinunternehmen.de) verwenden möchtet:

1. CNAME-Eintrag anlegen

Legt bei eurem DNS-Provider einen CNAME-Eintrag an, der auf den Plattform-Eintrittspunkt zeigt:

app.meinunternehmen.de.  CNAME  coolai.btc-ag.cloud.

2. Domain in der Plattform eintragen

Anwendung öffnen → “Domains” → “Domain hinzufügen”:

https://app.meinunternehmen.de

3. TLS-Zertifikat

Das Zertifikat wird automatisch beim nächsten Deployment oder innerhalb weniger Minuten ausgestellt. Voraussetzung: Der DNS-Eintrag muss aktiv und propagiert sein.

Via API

# Domain zu einer Anwendung hinzufügen
curl -s -X PATCH https://coolai.btc-ag.cloud/api/v1/applications/<app-uuid> \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fqdn": "https://app.meinunternehmen.de"
  }'

Für mehrere Domains kommagetrennt:

-d '{"fqdn": "https://app.meinunternehmen.de,https://www.meinunternehmen.de"}'

Troubleshooting

Problem	Ursache	Lösung
Domain nicht erreichbar	DNS noch nicht propagiert	`dig app.meinunternehmen.de` ausführen, auf Auflösung warten
TLS-Fehler im Browser	Zertifikat noch nicht ausgestellt	5–10 Minuten warten, dann erneut testen
Zertifikat für falsche Domain	`fqdn`-Feld enthält Tippfehler	Domain in der Anwendung prüfen und korrigieren
HTTP statt HTTPS	`https://`-Prefix fehlt	Domain-Eintrag mit `https://` beginnen