Custom Domains

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

---

Empfohlen: Subdomains unter *.ai.btc-ag.cloud

Für Anwendungen auf dem App-Server der Plattform ist ein Wildcard-DNS-Eintrag bereits gesetzt:

*.ai.btc-ag.cloud  →  App-Server (188.34.111.143)

Das bedeutet: Ihr könnt Subdomains wie meine-app.ai.btc-ag.cloud sofort verwenden, ohne DNS-Aufwand. Einfach die Domain in der Anwendungskonfiguration eintragen — fertig.

Tip

Wenn ihr beim Anlegen der Anwendung das richtige Coolify-Projekt (nicht das interne Root-Projekt) wählt, landet die App automatisch auf dem App-Server — und damit im Bereich des Wildcards.

---

Subdomains unter btc-ag.cloud (andere Subdomains)

Für Subdomains unter anderen *.btc-ag.cloud-Präfixen 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.

Note

Bei Apex-Domains (ohne Subdomain, also z. B. meinunternehmen.de) ist ein CNAME nicht möglich. Verwendet stattdessen einen A-Record — die IP-Adresse erhaltet ihr vom Platform-Team.

2. Domain in der Plattform eintragen

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

https://app.meinunternehmen.de

Tip

Immer https:// voranstellen — die Plattform konfiguriert sonst kein automatisches TLS.

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 '{
    "domains": "https://app.meinunternehmen.de"
  }'

Für mehrere Domains kommagetrennt:

-d '{"domains": "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	Domain-Feld enthält Tippfehler	Domain in der Anwendung prüfen und korrigieren
HTTP statt HTTPS	https://-Prefix fehlt	Domain-Eintrag mit https:// beginnen