Je eigen domein aan een app koppelen

Elke app krijgt van ons een adres, maar je wilt hem waarschijnlijk op je eigen domein. Deze gids laat zien hoe je een domein of subdomein aan een app koppelt, welk DNS-record je moet aanmaken en hoe je controleert of het gelukt is. HTTPS wordt voor je geregeld, zonder extra kosten.

Wat je nodig hebt

Een app die draait in het panel.
Een domein dat je beheert, met toegang tot de DNS-instellingen. Dat kan een bij ons geregistreerd domein zijn of een domein van een andere aanbieder.

Het domein aan je app toevoegen

Log in op het panel, open Apps en klik op je app.
Zoek de kaart Eigen domeinen en klik op Domein toevoegen.
Vul onder Hostnaam het adres in dat je wilt gebruiken. Gebruik een subdomein zoals blog.example.com of het domein zelf, zoals example.com.
Klik op Toevoegen.

Het panel toont nu het DNS-record dat je domein nodig heeft. Het domein staat in de lijst met de status in afwachting tot dat record er is.

Het DNS-record aanmaken

Er zijn twee manieren om je domein naar de app te laten wijzen.

Optie 1: een CNAME-record (aanbevolen)

Maak voor je hostnaam een CNAME-record aan dat wijst naar het doel dat het panel toont. Dat doel is het eigen adres van de app, dus dit record bewijst meteen dat het domein voor deze app bedoeld is. Meer is niet nodig.

Optie 2: een A-record

Sommige DNS-aanbieders staan geen CNAME toe op het domein zelf (example.com zonder iets ervoor). In dat geval:

Maak een A-record aan dat wijst naar het IP-adres dat het panel toont.
Maak ook het TXT-record aan dat het panel toont. De naam begint met _panel-challenge. gevolgd door je hostnaam, en de waarde is een code die bij jouw app hoort.

Het TXT-record is verplicht bij een A-record. Veel klanten delen hetzelfde IP-adres, en aan het TXT-record zien wij dat het domein echt van jou is.

Als je DNS bij ons staat

Wordt de DNS-zone van het domein in het panel beheerd, dan hoef je niets te kopiëren. Klik op DNS automatisch instellen en het panel maakt de records voor je aan. Bestaat er al een record met die naam, dan vragen we om bevestiging voordat het wordt vervangen.

Wachten op verificatie

We controleren het record automatisch om de paar minuten. Wil je direct controleren, klik dan in de lijst op het vernieuwpictogram naast het domein.

Zodra het record gevonden is, verandert de status in geverifieerd.
Daarna wordt HTTPS automatisch ingesteld. Dat duurt meestal minder dan een minuut en hooguit ongeveer drie minuten.
Je eerste geverifieerde domein wordt het hoofdadres van de app. De app herstart daarvoor even.

DNS-wijzigingen zijn niet direct zichtbaar. Heb je het record net aangemaakt, wacht dan een paar minuten voordat je het opnieuw probeert.

Met Cloudflare

Loopt je domein via de Cloudflare-proxy (het oranje wolkje), dan werkt de verificatie nog steeds, maar je hebt ook het TXT-record uit optie 2 nodig. Zet de SSL/TLS-modus bij Cloudflare op Full of Full (strict), zodat HTTPS tot aan je app werkt.

Als de verificatie mislukt

De lijst toont de reden onder het domein. De meest voorkomende:

Het record wijst ergens anders heen. Vergelijk het doel of IP-adres met wat het panel toont. Misschien bestaat er nog een oud record met dezelfde naam.
Het domein wordt nog niet gevonden. Het record is nieuw en nog niet overal bekend, of het is onder de verkeerde naam aangemaakt.
Het TXT-record ontbreekt. Bij een A-record of een domein achter een proxy moet het TXT-record _panel-challenge bestaan en precies de getoonde waarde bevatten.

Een domein verwijderen

Open de kaart Eigen domeinen, klik op het verwijderpictogram naast het domein en bevestig met Verwijderen. Het domein toont je app dan niet meer. Vergeet niet om ook het DNS-record bij je aanbieder te verwijderen.

Heb je nog geen domein? Zie Een domein registreren.