Website settings

Every card on a website's Settings tab, from registration, nameservers and renewal to the DNS zone, DNSSEC and deleting.

View as Markdown

In the dashboard

/dashboard/websites/…/settings

A website's Settings tab shows only the cards that apply to the domain. The registrar cards appear for a domain registered with Coritan, Platform name for a free name you claimed, and the zone cards when Coritan hosts the domain's DNS. A domain with neither a registration nor a zone here shows Nothing to configure.

Registration

Section titled Registration

The Registration card shows the registrar's status as a badge, and these rows:

Row	What it shows
Domain	The domain name.
Registrar status	The registration's status, such as `active` or `pending_transfer`.
Registered	The registration date.
Expires	The expiry date, and how many days are left. The count is highlighted when fewer than 30 days are left, and shows Expired after the date.
Auto-renew	On or Off.
WHOIS privacy	On or Off.
Transfer lock	Locked or Unlocked.
DNS zone	Hosted here, which opens the DNS tab, or Elsewhere.
Proxy route	The web proxy linked to the registration, which opens it in Edge Proxy, or None.
Certificate	The certificate linked to the registration, which opens the SSL tab, or None.

The switches, the nameservers, the EPP code and renewing all need the registration to be active. Statuses explains each status.

Domain options

Section titled Domain options

Switch	What it does	Page
Auto-renew	Renews the domain before it expires.	Renew a domain
WHOIS privacy	Hides your contact details from public WHOIS lookups.	Turn on WHOIS privacy and transfer lock
Transfer lock	Makes the registry refuse transfer requests from other registrars.	Turn on WHOIS privacy and transfer lock

Each switch saves as soon as you change it.

Nameservers

Section titled Nameservers

The Nameservers card lists the nameservers the registry sends resolvers to for the domain. Edit nameservers opens a list of fields, with Add nameserver and a remove button on each field, and Save nameservers saves it. The list takes 2 to 13 nameservers. Change a domain's nameservers has the steps.

EPP code

Section titled EPP code

The EPP code card has Reveal EPP code, which shows the code another registrar needs to take the domain over. The button stays off while Transfer lock is on. The code shows once, and Hide clears it from the screen. Transfer a domain to another registrar has the steps.

Renewal

Section titled Renewal

The Renewal card extends the registration by 1 to 10 years: choose the period, then select Renew domain. Renew a domain has the steps.

Platform name

Section titled Platform name

For a free name, such as survival-smp.coritan.gg, the Platform name card shows:

Row	What it shows
Name	The name you claimed.
Delegated from	The Coritan domain the name sits under, such as `coritan.gg`.
Claimed	The date you claimed it.
Renewal	A free name needs no renewal. It stays yours while its zone exists.

A free name cannot move to a registrar or use other nameservers. Claim a free coritan.gg name explains how it works.

DNS zone

Section titled DNS zone

The DNS zone card appears when Coritan hosts the domain's zone.

Row	What it shows
Status	`active` while Coritan's nameservers answer for the zone. A `suspended` zone has its queries refused (Failed payments and suspended services).
Serial	The SOA serial, which goes up with every change to the zone.
Records	How many records the zone holds.
SOA contact	The address the zone's SOA record names as responsible for it, `hostmaster@` the domain until you change it.

To change the contact, select Edit contact, enter an address in SOA contact email and select Save contact. The dashboard asks for a full address, such as hostmaster@example.com, and confirms Zone contact saved.. Saving raises the zone's serial. How DNS hosting works explains the SOA record.

DNSSEC

Section titled DNSSEC

The DNSSEC card shows whether the zone is signed, and for a signed zone:

Row	What it shows
Algorithm	The signing algorithm.
KSK key tag	The tag of the key-signing key, which the DS records name.
ZSK key tag	The tag of the zone-signing key.
Last ZSK rotation	The date the zone-signing key last changed.

An unsigned zone shows Signing is off for this zone.

DS records for the registrar

Section titled DS records for the registrar

For a signed zone, the DS records for the registrar card lists the DS records to publish at the domain's registrar, each with a copy button. Set up DNSSEC has the steps.

Delete or release

Section titled Delete or release

Card	Button	What it does	Page
Delete the DNS zone	Delete zone…	Deletes the zone and every record in it, after you type the domain.	Delete a DNS zone
Release this name	Release name…	Deletes a free name's zone and everything in it, and returns the name to the pool, after you type the name.	Claim a free coritan.gg name

Change the zone contact with the API

Section titled Change the zone contact with the API

PATCH /api/v1/dns/zones/{zone_id} changes the zone's soa_email, the only field it takes:

Shell

curl -X PATCH https://api.coritan.com/api/v1/dns/zones/42 \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"soa_email": "hostmaster@example.com"}'

The answer is the zone, with soa_email as saved. The API stores the value in lower case. A value without @, such as hostmaster, stands for that name at the zone itself, hostmaster@example.com.

422 with No fields to update: The body has no soa_email.
422 with soa_email cannot be empty or soa_email too long: Send an address of 1 to 255 characters.
403 with Access denied: The zone is not on your account.

API operations on this page

Method	Path	What it does
`PATCH`	`/api/v1/dns/zones/{zone_id}`	Update zone