Domains and DNS

Customers can register domain names and host DNS zones on your nameservers. Domains are registered through Openprovider or by hand. DNS zones are hosted on PowerDNS. Only staff with the owner or admin role can change these settings.

Registrar#

Open Domains in the Hosting group. The Registrar card has these fields:

FieldRules and meaning
RegistrarManual (process registrations yourself) or Openprovider. Default: manual.
Renew days before expiry1 to 120. Default: 30. Stacklane renews domains with auto-renew this many days before they expire.
API endpointOpenprovider only. Must start with https://. Default: https://api.openprovider.eu.
UsernameOpenprovider only. Required.
PasswordOpenprovider only. Stored encrypted. Leave it empty to keep the current one. When you change the endpoint or the username, you must enter the password again.
Default nameserversZero, or two to six host names, separated by commas. Each host name must have at least three labels, for example ns1.example.net. New registrations use these nameservers when the customer does not enter others.

Click Save.

Openprovider#

With Openprovider, Stacklane:

Stacklane registers each domain with auto-renew turned off at Openprovider, because Stacklane handles renewals itself. The same contact handle is used as owner, admin, tech and billing contact.

For the first registration of an organization, Stacklane creates a customer contact at Openprovider from the organization details. It saves the contact handle and uses it for later registrations. The organization needs:

If something is missing, the registration fails with "contact details are incomplete" and the customer gets the money back as credit.

Manual registrar#

With the manual registrar, Stacklane does not contact any registrar.

You make all registrations, renewals and nameserver changes at your registrar yourself.

To finish a manual registration:

  1. Register the domain at your registrar.
  2. Open Domains in the back office. The card All domains lists the domains of all organizations.
  3. Click Mark as registered next to the domain.

The portal sets the expiry date to one year from now. Through the API you can set another expiry date and the registrar's ID for the domain:

curl -X POST https://panel.example.com/api/admin/domains/domains/<domain-id>/activate \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"expires_at": 1830297600, "remote_id": "12345678"}'

expires_at is a Unix time in seconds and must be in the future. Only domains with the status pending can be activated. Staff with the support role can also do this.

Extensions and prices#

The card Extensions and prices lists the extensions customers can register. Click Add extension.

FieldRules and meaning
ExtensionFor example com, nl or co.uk, without the leading dot. Up to 24 characters.
Registration priceThe price for one year of registration, 0 to 100,000.00.
Renewal priceThe price for one year of renewal, 0 to 100,000.00.
CurrencyMust be the billing currency.
Statusactive or disabled. Customers can only register active extensions.

Stacklane splits a domain name at the first dot. In shop.co.uk the extension is co.uk.

When a customer searches, Stacklane shows up to eight results: first the extension the customer typed (if it has a price), then other active extensions.

How customers pay for domains#

Domains are paid from the credit balance, not on the monthly invoice.

Only users with the administrator or billing role can register domains. Customers turn auto-renew on or off per domain.

Domain statuses#

StatusMeaning
pendingThe registration is in progress, or waits for a staff member with the manual registrar.
activeThe domain is registered.
expiredThe expiry date has passed. Stacklane checks this every hour. The customer must contact support.
failedThe registration failed. The amount was refunded.
cancelledThe order was stopped because of too little credit.

DNS hosting#

Open DNS hosting in the Hosting group.

FieldRules and meaning
DNS serverDisabled or PowerDNS. Default: disabled. When DNS hosting is disabled, customers cannot add or change zones.
PowerDNS API URLThe address of the PowerDNS HTTP API, for example http://10.0.0.53:8081.
Server IDThe PowerDNS server ID. Default: localhost.
API keyThe PowerDNS API key. Stored encrypted. Leave it empty to keep the current key. When you change the URL to another host, you must enter the key again.
Verify TLSOn by default.
NameserversAt least two host names, for example ns1.example.net and ns2.example.net. Required for PowerDNS.
Zones per organization0 to 10,000. Default: 50.

How Stacklane uses PowerDNS#

Stacklane calls the PowerDNS API under <API URL>/api/v1/servers/<server ID>/ with the header X-API-Key.

PowerDNS must serve the zones on the nameservers you enter. Customers see these nameservers on the zone page with the text "Point the domain to these nameservers".

Zone rules#

Customers can use the record types A, AAAA, CNAME, MX, TXT, NS, SRV and CAA. See Customer portal.

API endpoints#

MethodPathStaff rolesDescription
GET, PUT/api/admin/domains/settingsowner, adminRead or save the registrar settings.
GET/api/admin/domains/tldsowner, adminList extensions and prices.
PUT, DELETE/api/admin/domains/tlds/{tld}owner, adminSave or remove an extension. Body for PUT: {"register_cents": 999, "renew_cents": 1299, "currency": "EUR", "status": "active"}.
GET/api/admin/domains/domainsowner, admin, supportList the domains of all organizations.
POST/api/admin/domains/domains/{id}/activateowner, admin, supportMark a pending domain as registered.
GET, PUT/api/admin/dns/settingsowner, adminRead or save the DNS hosting settings.

Example body for PUT /api/admin/dns/settings:

{
  "provider": "powerdns",
  "endpoint": "http://10.0.0.53:8081",
  "server": "localhost",
  "api_key": "<PowerDNS API key>",
  "verify_tls": true,
  "nameservers": ["ns1.example.net", "ns2.example.net"],
  "max_zones": 50
}

Free subdomains for game servers#

You can give customers a free address for their game server, for example survival.play.example.net.

  1. Open DNS in the Hosting group of the back office.
  2. Set Game server zone to a zone on your PowerDNS server, for example play.example.net. If the zone does not exist yet, Stacklane creates it with your nameservers the first time a customer claims a name.
  3. Save.

A customer then picks a name of 3 to 32 letters, numbers and dashes on the Minecraft tab. Stacklane creates:

RecordValue
A (or AAAA) for the nameThe IP address of the primary port of the server.
SRV for _minecraft._tcp.<name>0 5 <port> <name>.

If the primary port only has an alias host name, the SRV record points to that host name instead. Players can then connect without typing a port. Names such as www, mail, api and panel are reserved. Stacklane removes the records when the customer removes the name or cancels the service.