Domeinen beheren op een cPanel-account

Elk cPanel-hostingaccount heeft één hoofddomein, vastgelegd toen het account werd aangemaakt. Al het andere dat je op het account host — een tweede website, een tweede naam voor dezelfde website, een subdomein — voeg je daarna toe op het scherm Domeinen van het account in het CloudPress-dashboard.

Deze pagina behandelt dat scherm: hoe je er komt, wat de drie soorten extra domein doen, hoe toevoegen werkt (het is niet direct klaar), wat er gebeurt als je pakket vol raakt, en hoe je een domein weer verwijdert. Het dagelijkse werk binnen een domein — bestanden, e-mailaccounts, redirects — gebeurt nog steeds in cPanel zelf.

Voordat je begint

cPanel hosting ingeschakeld voor je workspace, en een account in de lijst — zie cPanel hosting: overzicht
Rechten om de facturatie te beheren op de workspace die het account bezit. De domeinlijst bekijken kan elk lid van de workspace, maar een domein toevoegen en verwijderen niet: zonder dat recht kom je terug op de lijst met cPanel-accounts met de melding "Je hebt geen toestemming om de facturering voor dit account te beheren."
Voor een addon- of aliasdomein: een domeinnaam die al bestaat — het dashboard weigert hosting te koppelen aan een naam die nergens geregistreerd is. Subdomeinen zijn hiervan uitgezonderd, omdat hun bovenliggende domein al op het account staat.
Het moet een hostingaccount zijn. Mail-only accounts (MailXXL) hebben geen actie Domeinen beheren, en een geblokkeerd account toont helemaal geen acties.
De verwijdering van het account mag niet gepland staan. Een account waarvan de verwijdering gepland staat, is vergrendeld: de rij biedt alleen Herstellen en Nu verwijderen, en een domein toevoegen of verwijderen wordt geweigerd — ook via de API — totdat het is hersteld. Zie Een cPanel-account verwijderen en herstellen.

Het scherm Domeinen openen

Open de accountlijst. Kies cPanel accounts in de workspace-sidebar.
Kies Domeinen beheren. Open het actiemenu op de rij van het account — het menu waar ook Upgraden / Downgraden en Wachtwoord wijzigen in staan — en kies Domeinen beheren.
Lees de pagina. Die heet Domeinen, met als ondertitel "Parked-, addon- en subdomeinen voor" de gebruikersnaam van je account, en toont drie gebruikstellers boven een tabel met elk domein op het account. De tabel heeft de kolommen Domein en Type, en elke rij draagt een typebadge — Hoofddomein, Addon, Alias of Subdomein. Een account met niets meer dan zijn hoofddomein toont "Nog geen domeinen" met de hint "Maak een parked-, addon- of subdomein aan om te beginnen."

De tellers zijn Addondomeinen, Aliassen en Subdomeinen. Elk toont hoeveel er van dat soort in gebruik zijn en, waar het pakket van het account een maximum stelt, hoeveel het toestaat — als in gebruik / toegestaan. Een soort zonder maximum leest Onbeperkt, en een soort die zijn maximum heeft bereikt is gemarkeerd als Vol.

Dit scherm leest de hostingserver rechtstreeks

Anders dan de lijst met cPanel-accounts, die waarden uit een periodiek ververste kopie serveert, leest het scherm Domeinen de domeinen van het account live van de hostingserver — een domein dat je in cPanel hebt toegevoegd of verwijderd, verschijnt hier dus zonder wachten. De kolom Hoofddomein terug op de accountlijst is de gecachete variant, en kan tot tien minuten achterlopen.

De drie soorten domein

Je kiest ze nooit uit een menu. Je typt een naam en het dashboard leidt af welk soort het is, met hooguit één vraag.

Soort	Wat het is	Waar de bestanden staan
Addon	Een tweede, losse website op hetzelfde account	Een eigen map, standaard een nieuwe map onder `public_html`
Alias	Een andere naam voor de site die je al hebt	De map van het hoofddomein — een alias deelt altijd de inhoud van het hoofddomein, nooit die van een addon
Subdomein	Een extra label vóór een domein dat al op het account staat, zoals `blog.`	Een eigen map, standaard een nieuwe map onder `public_html`

Een addondomein wordt intern ondersteund door een subdomein van het hoofddomein van het account, en het toevoegscherm vertelt je welk voordat je bevestigt: "Om dit domein eigen bestanden te geven, voegen we het subdomein" … "toe." Dat is de manier waarop cPanel addondomeinen zelf inricht, niet iets specifieks voor CloudPress.

Een domein toevoegen

Kies Nieuw domein aanmaken. De knop staat in de header van het scherm Domeinen en opent Domein toevoegen, dat zichzelf in één regel uitlegt: "Typ een domein of subdomein — wij zoeken de rest uit."
Typ de naam. Het enige veld heet Domein, met de placeholder "example.com of blog.example.com". Typ het geheel — shop.example.com, niet een label en een bovenliggend domein die je apart kiest.
Lees wat eruit is afgeleid. Even nadat je stopt met typen vertelt de pagina wat ze denkt dat de naam is:
- Een subdomein van een domein dat al op het account staat → "Dit lijkt een subdomein van" dat domein. Verder niets te beantwoorden.
- Een naam die nog niet op het account staat → "Dit lijkt een nieuw domein. Nog één vraag hieronder."
- Iets dat geen hostnaam is → "Dat lijkt geen geldige domeinnaam te zijn."
- Een naam die je hier niet kunt koppelen → "Dit domein kan niet aan dit account worden toegevoegd." — zie Wanneer een domein wordt geweigerd.
Beantwoord die ene vraag, als je hem krijgt. Bij een nieuw domein vraagt de pagina Wat moet dit domein laten zien? en biedt twee keuzes:
- Een eigen, losse site — "Nieuwe lege map". Dit maakt een addondomein.
- Dezelfde inhoud als een bestaande site — "Deelt inhoud met een van je bestaande domeinen", getoond als "Verwijst naar" het hoofddomein zodra het dat kan benoemen. Dit maakt een alias.
Stel een documentmap in, als je dat wilt. Geavanceerd opent een veld Documentmap (optioneel), dat "Standaard een nieuwe map onder public_html." is. Laat het met rust tenzij je een reden hebt.
Kies Domein toevoegen. Er verschijnt een melding terwijl de aanvraag loopt — "Domein wordt toegevoegd — dit kan een minuutje duren…" — en de knop is niet beschikbaar zolang de pagina nog bijwerkt wat je hebt getypt. Ziet hij er dus even inactief uit, wacht dan tot de detectie is uitgewerkt in plaats van doorheen te klikken.
Wacht tot de rij verschijnt. Je komt terug op het scherm Domeinen met "Domein aangemaakt — het kan een minuutje duren voordat het hieronder verschijnt." Staat het nieuwe domein nog niet in de tabel, dan ververst de lijst zichzelf elke paar seconden tot het er staat, ongeveer een minuut lang; je hoeft de pagina niet opnieuw te laden.

Waarom het wachten echt is

De hostingserver bouwt zijn webserverconfiguratie opnieuw op wanneer er een domein bij komt, en dat is een tel later klaar dan het moment waarop de aanvraag van het dashboard succesvol terugkomt. Dat gat is waar de melding en de zelfverversende lijst voor bestaan — het domein wordt al aangemaakt terwijl je erop staat te wachten. Is er een minuut voorbij en staat de rij er nog steeds niet, laad het scherm dan opnieuw voordat je aanneemt dat het toevoegen is mislukt.

Wat het toevoegen van een domein met DNS doet

Een domein toevoegen op dit scherm raakt zowel cPanel als je CloudPress-DNS:

Een addon- of aliasdomein krijgt een DNS-zone in CloudPress, gevuld vanaf de hostingserver zodat de adresrecords van het domein naar het account wijzen.
Bij een subdomein worden de adresrecords toegevoegd aan de bestaande zone van het bovenliggende domein.

Dit loopt een paar seconden achter op het domein zelf, en probeert het uit zichzelf opnieuw als de hostingserver de zone nog niet klaar heeft. Records die diensten beschrijven die jij hebt gekozen — mailroutering, SPF en andere TXT-records, CAA, SRV — worden niet overschreven; alleen de records die zeggen waar het domein gehost wordt volgen de cPanel-server. Je kunt het resultaat bekijken en bewerken onder Domeinen in de workspace-sidebar — zie DNS beheren.

Wanneer je pakket vol is

Addondomeinen en aliassen worden beide begrensd door het pakket van het account, en die twee maxima staan los van elkaar. Wanneer er een is bereikt:

De bijbehorende teller op het scherm Domeinen toont Vol.
Op het toevoegscherm is de bijbehorende keuze grijs en draagt hij de reden — "Dit account mag" zoveel "addondomein(en) hebben. Upgrade het pakket om er meer toe te voegen.", of dezelfde zin voor aliasdomeinen.
Toch versturen wordt geweigerd met die melding in plaats van met een serverfout.

De oplossing is een groter pakket: zie Je pakket aanpassen. Het upgradescherm toont hoeveel addondomeinen het account op dit moment gebruikt, zodat je kunt zien welke pakketten daadwerkelijk kunnen bevatten wat je al hebt.

Subdomeinen worden op dit scherm ook geteld, maar het dashboard blokkeert een subdomein niet voordat het die verstuurt — de hostingserver beslist. Wordt een subdomein daar geweigerd, dan zie je de reden in de foutmelding en niet in de teller.

Wanneer een domein wordt geweigerd

Sommige namen kunnen niet aan een cPanel-account worden gekoppeld, en het scherm zegt dat met één bewust weinig specifieke melding: "Dit domein kan niet aan dit account worden toegevoegd." Je krijgt hem wanneer de naam elders op CloudPress al vergeven is — geregistreerd op, of met DNS gehost voor, een account buiten je facturatiefamilie, of al in gebruik op iemand anders zijn cPanel-account — en ook wanneer de naam nergens geregistreerd is.

De melding is in elk geval hetzelfde, en dat is met opzet: uitspellen welke reden gold, zou iedereen in staat stellen namen in dit veld te typen om te ontdekken wat CloudPress erover weet.

Dus als je hem tegenkomt:

Controleer eerst de spelling. Een verkeerd getypt domein is een ongeregistreerd domein.
Heb je de naam nog niet geregistreerd, registreer hem dan — zie Een domein kopen. Hosting wordt alleen gekoppeld aan een naam die bestaat.
Is het een naam die je al bezit maar die op een andere workspace staat of ergens anders is ingericht, neem dan contact met ons op in plaats van te gokken.

Subdomeinen slaan deze controle helemaal over — hun bovenliggende domein staat al op het account, dus er valt niets vast te stellen.

Een domein verwijderen

Een domein verwijderen haalt het van het cPanel-account af en haalt alles wat eronder werd aangeboden offline. Er is op dit scherm geen ongedaan maken.

Zoek de rij en kies Verwijderen. Elke rij behalve die van het Hoofddomein heeft een knop Verwijderen; het hoofddomein van het account kan hier helemaal niet worden verwijderd.
Bevestig. Een dialoogvenster Domein verwijderen legt uit wat er gaat gebeuren — "Dit verwijdert" het domein "van dit cPanel-account. Content die hieronder wordt aangeboden kan hierdoor onbereikbaar worden." — met Annuleren en Bevestigen.
Bevestig je identiteit met je passkey of wachtwoord, als je dat niet recent hebt gedaan. Verwijderen is een van de gevoelige acties die je vraagt opnieuw te bevestigen wie je bent.
Wacht tot het klaar is. Terwijl de aanvraag loopt staat er "Domein wordt verwijderd — dit kan een minuutje duren…", en de rij verdwijnt met "Domein" … "verwijderd." zodra het klaar is. Een mislukking komt terug als "Kon het domein niet verwijderen:" gevolgd door wat de server zei, en het domein blijft staan waar het stond.

Verwijderen is vanaf dit scherm niet terug te draaien

Er is geen herstelknop voor een verwijderd domein. Dezelfde naam opnieuw toevoegen werkt, maar dan maak je hem opnieuw vanaf nul — controleer of er niets meer onder het domein wordt aangeboden voordat je bevestigt.

Wat er met DNS gebeurt, hangt af van het soort:

Een addon- of aliasdomein verwijderen laat de CloudPress-DNS-zone ervan staan, zodat een domein dat je later opnieuw toevoegt verdergaat waar het gebleven was.
Een subdomein verwijderen haalt de adresrecords van dat subdomein uit de zone van het bovenliggende domein.

Via de API

Alles op dit scherm is ook via de REST API beschikbaar, met dezelfde regels erachter — dezelfde eigendomscontroles, dezelfde pakketlimieten en hetzelfde DNS-werk:

De domeinen van het account opvragen, met hun soort en de gebruikstellers die je hierboven ziet.
Een domein toevoegen. De API raadt het soort niet voor je, zoals het invoerveld met automatische detectie dat doet — je geeft zelf aan of het een alias (parked), een subdomein of een addon is. Net als in het dashboard is het domein niet live op het moment dat de aanroep terugkomt: poll de domeinenlijst tot het erin verschijnt.
Een domein verwijderen. Het soort wordt voor je afgeleid uit de lijst van het account zelf, en het hoofddomein kan ook hier niet worden verwijderd.

Toevoegen en verwijderen vereisen dezelfde rechten om de facturatie te beheren als in het dashboard, gecontroleerd op de workspace die het account bezit, en ze vereisen een API-sleutel of een ingelogde sessie — een OAuth-accesstoken wordt geweigerd, welke scopes het ook draagt. Opvragen is de uitzondering en werkt met de scope cpanel:read.

Volgende stappen

Doe de rest van het werk in het configuratiescherm — zie Inloggen op cPanel
Addondomeinen of aliassen op? Pas je pakket aan
Richt het nieuwe domein waar je het hebben wilt met DNS beheren
Registreer een naam die je nog niet bezit met Een domein kopen
Fris op wat een cPanel-account is in cPanel hosting: overzicht