Studio

Eigene Domains

Mit einer eigenen Domain werden deine Landingpage, Rechtstexte, dein Pressekit, QR-Codes und Deep Links von einer Domain ausgeliefert, die dir gehört, etwa get.habitly.app. HTTPS richten wir für dich ein. Eigene Domains sind Teil des Studio-Plans, der bis zu 25 Domains pro Workspace umfasst. Workspace-Owner und Admins können sie hinzufügen.

Was eine eigene Domain ausliefert

Jede Domain ist mit einer App verbunden:

URL	Liefert aus
`https://get.habitly.app/`	Landingpage
`/go/{store}`	Erfasste Weiterleitung zu einem Store, etwa `/go/google_play`
`/open/{path}`	Deep Links
`/privacy`, `/terms`	Datenschutzerklärung und Nutzungsbedingungen, optional mit `/{language}`
`/press`, `/press.zip`	Pressekit
`/qr.svg`, `/qr.png`	QR-Code
`/.well-known/apple-app-site-association` `/.well-known/assetlinks.json`	Zuordnungsdateien für Universal Links und Android App Links

Die Root-Adresse zeigt allen die Landingpage. Anders als mapps.one/habitly leitet sie Smartphones nicht zu einem Store weiter. Verwende den Smart Link, wenn du eine Geräteerkennung möchtest, oder get.habitly.app/go/app_store, wenn du einen bestimmten Store willst. Smart-Link- und QR-Code-URLs im Dashboard und in der API verwenden weiterhin mapps.one.

Bevor du loslegst

Verwende eine Subdomain, etwa get., download. oder app.. Der DNS-Standard erlaubt keine CNAME-Einträge auf einer Root-Domain wie habitly.app.
Du brauchst Zugriff auf die DNS-Einstellungen der Domain, bei deinem Registrar oder DNS-Anbieter.
Eine Domain kann in ganz mapps.one nur einmal verbunden werden.

1. Domain hinzufügen

Öffne im Dashboard Domains, wähle Domain hinzufügen, gib get.habitly.app ein und wähle die App, die darüber ausgeliefert werden soll. Das Dashboard zeigt dir dann die DNS-Einträge, die du anlegen musst, einschließlich eines Verifizierungstokens, das nur für deine Domain gilt.

2. DNS-Einträge anlegen

Typ	Name	Wert	Zweck
TXT	`_mapps-verify.get.habitly.app`	`mapps-verify=your-token`	Belegt, dass du die Domain kontrollierst
CNAME	`get.habitly.app`	`domains.mapps.one`	Leitet den Traffic zu mapps.one

Wenn dein DNS-Anbieter für diesen Namen keinen CNAME-Eintrag anlegen kann, lege stattdessen einen A-Eintrag an, der auf die im Dashboard angezeigte IP-Adresse zeigt.

Viele DNS-Anbieter hängen deine Root-Domain automatisch an. Gib in diesem Fall nur den Teil davor ein: _mapps-verify.get für den TXT-Eintrag und get für den CNAME-Eintrag.

Du nutzt Cloudflare? Stelle den CNAME-Eintrag auf DNS only (graue Wolke). Läuft der Eintrag über den Proxy, kann das Zertifikat nicht ausgestellt werden, und Besucher sehen einen Fehler.

3. Verifizieren

Wähle Jetzt verifizieren neben der Domain. Wir prüfen den TXT-Eintrag und wohin die Domain zeigt. Ausstehende Domains werden außerdem alle 10 Minuten automatisch geprüft, du kannst die Seite also schließen und später zurückkommen. DNS-Änderungen sind meist innerhalb von Minuten sichtbar, manche Anbieter brauchen aber einige Stunden.

Status	Bedeutung
Ausstehend	Wartet darauf, dass die DNS-Einträge sichtbar werden
Verifiziert	Die Domain liefert deine App aus
Fehlgeschlagen	Ein Eintrag fehlt oder ist falsch. Das Dashboard zeigt den Grund. Korrigiere den Eintrag und verifiziere erneut.

Ist die Verifizierung erfolgreich, wird ein Webhook vom Typ domain.verified gesendet.

HTTPS

Ein TLS-Zertifikat wird automatisch ausgestellt, sobald jemand die Domain nach der Verifizierung zum ersten Mal über HTTPS öffnet. Diese erste Anfrage kann einige Sekunden dauern, spätere Anfragen sind schnell. Du musst nichts hochladen oder erneuern.

Fehlerbehebung

Prüfe mit dig oder einem beliebigen Online-Tool für DNS-Abfragen, was die Welt sieht:

dig +short TXT _mapps-verify.get.habitly.app
"mapps-verify=your-token"

dig +short CNAME get.habitly.app
domains.mapps.one.

Der Name ist doppelt, wie in get.habitly.app.habitly.app: Dein Anbieter hat die Root-Domain angehängt. Gib nur get ein.
Es gibt einen weiteren Eintrag für denselben Namen, etwa einen alten A-Eintrag. Entferne ihn, denn ein CNAME kann sich seinen Namen nicht mit anderen Einträgen teilen.
Proxy oder CDN davor: Stelle den Eintrag auf DNS only um.
CAA-Einträge auf deiner Domain, die nur eine bestimmte Zertifizierungsstelle zulassen, können das Zertifikat blockieren. Entferne oder erweitere sie.

Domain entfernen

Lösche die Domain im Dashboard und entferne dann die DNS-Einträge bei deinem Anbieter. Wechselt der Workspace aus dem Studio-Plan, liefern seine eigenen Domains keine Seiten mehr aus, bis du wieder upgradest. Links auf mapps.one funktionieren weiterhin.