Domains
Jede App hat in jedem Environment eine eigene URL unter connic.app. Liefere sie stattdessen unter einer eigenen Subdomain aus, festgelegt im Code oder im Dashboard.
Auf dieser Seite
Standard-URL
Jede App bekommt in jedem Environment, in das sie deployt wird, die Adresse https://<key>-<id>.connic.app, etwa https://portal-1a2b3c4d.connic.app. Der erste Teil ist der Key der App in Kleinbuchstaben, andere Zeichen werden zu Bindestrichen, gekürzt auf 40 Zeichen; die ID ist zufällig und in jedem Environment anders. Die URL bleibt über Deployments und Rollbacks gleich, und eine App, die ein Deployment nicht mehr deklariert, bekommt sie zurück, wenn sie wiederkommt.
Die Standard-URL steht auf dem Tab Settings der App unter Domain. Mit einer Custom Domain antwortet die App unter beiden Adressen, außer du schaltest die connic.app-Adresse ab.
Custom Domain
Füge die Domain zuerst unter Project Settings → Domains hinzu und verifiziere sie, wie unter Custom Domains beschrieben. Danach gibst du sie der App auf einem von zwei Wegen:
- Setze
domaininapps/<key>.yamlauf den Hostnamen oder die ID der Domain. Variablen funktionieren hier. - Lass
domainin der Datei weg, wähle die Domain unter Custom domain auf dem Tab Settings der App und klicke auf Save changes.
environments:
Staging: {} # nur die Standard-URL
Production:
domain: portal.example.com # oder die ID der DomainDeklariert die Datei domain, zeigt das Dashboard die Domain mit dem Badge In code und kann sie nicht ändern. Hört ein Deployment auf, sie zu deklarieren, behält die App die Domain, und ab dann verwaltet das Dashboard sie; dort nimmst du sie mit No custom domain wieder ab.
Die Custom Domain hat eigene Sessions, Besucher melden sich dort also getrennt von der Standard-URL an. Wer die Domain unter Project Settings → Domains löscht, nimmt sie der App weg.
Nur die Custom Domain
Sobald eine Custom Domain gespeichert ist, schalte Serve on the connic.app address too unter Domain auf dem Tab Settings der App ab, oder sende default_url: false mit update_app in connic MCP. Die connic.app-Adresse leitet dann dauerhaft auf die Custom Domain weiter, mit 301 für GET und HEAD und 308 für andere Methoden, und behält Pfad und Query. Links auf die alte Adresse funktionieren weiter, und Suchmaschinen indexieren nur die Custom Domain.
Die Einstellung gibt es nur im Dashboard, nicht in apps/<key>.yaml. Ohne Custom Domain lässt sie sich nicht abschalten, und verliert die App ihre Custom Domain, etwa weil du sie entfernst oder löschst, liefert die connic.app-Adresse die App wieder aus.
Eine Domain, eine App
Eine Domain dient entweder einer App in einem Environment oder den URLs von Connectors. Ein Deployment scheitert und nennt den Konflikt, wenn die Domain einer App bereits von einem Connector, von einer anderen App im selben Deployment oder von einer App in einem anderen Environment genutzt wird. Deshalb setzt das Beispiel die Domain im Override eines einzigen Environments. Das Dashboard verweigert dasselbe, und Connectors können eine Domain nicht nutzen, solange eine App sie hat.
Connector-Pfade auf einer Custom Domain
Auf einer Custom Domain bleiben die Pfade von Connector-URLs reserviert und erreichen die App nicht: Pfade, deren erstes Segment webhook, mcp, s3, stripe, telegram, slack, ws, twilio, twilio-messaging, telnyx oder telnyx-messaging ist und die ein zweites Segment haben, etwa /slack/settings. Gib clientseitigen Routen andere Namen. Auf der Standard-URL erreicht jeder Pfad die App.