Skip to content
Coritan Docs

Claim a free coritan.gg name

Claim a free name under a Coritan domain such as coritan.gg, use it for your sites and servers, or release it.

View as Markdown

A coritan.gg name is a free name under coritan.gg, such as alex.coritan.gg, that Coritan lends to your account. Coritan creates a DNS zone for it on your account, so you can use it for mailboxes, a website, a game server's address or anything else you would put on a domain you own. Claim one when you want an address without buying a domain.

The name needs no renewal, and stays on your account while its DNS zone exists. A @coritan.gg mailbox, such as alex@coritan.gg, is a separate thing (Get a coritan.gg mailbox).

  • An account can hold 3 names. When yours holds 3, release one before you claim another.
  • Choose a name that follows the name rules. Join addresses and claimed names share the names under coritan.gg, so a name that a join address uses is not free.
  1. Open the claim form from one of these places:

    • The dashboard's home page, while your account holds no name: select Claim a name on the card that offers a free coritan.gg name. Right after you sign up with your own email address, the dashboard opens with the form already showing.
    • Websites: select the button that offers a free coritan.gg name. Once you hold a name, open the More website actions menu and select Claim another name… instead.
    • A form that asks for a domain, such as a mail service's domain or a web proxy's hostname: select the claim link under the field. With no name yet, the link follows No domain?.
  2. If the form shows Under, choose the Coritan domain to claim the name under. The form shows it only when Coritan offers more than one.

  3. In Name, type the name, such as alex. The form checks the name as you type, and shows alex.coritan.gg is available when it is free (Name rules).

    To use a name made from your profile instead, select one of the names beside Try. The form offers up to 3 free names, made from your name, your company and your email address. Under the field, the form also says how many more names the account can claim.

  4. Select the claim button, which reads Claim alex.coritan.gg once the name is available, or press Enter in Name.

A name is one label under coritan.gg, and must follow these rules:

  • It has 3–32 characters.
  • It uses lowercase letters, digits and hyphens, with no hyphen at either end.
  • It has no two hyphens in a row.
  • No join address and no other claim already has it.
  • It is not a reserved name.

The field changes what you type as you go. It turns capitals into lowercase letters and drops every character other than letters, digits and hyphens, so Alex_SMP becomes alexsmp.

These names are reserved: abuse, account, accounts, admin, administrator, api, app, apps, assets, auth, autoconfig, autodiscover, billing, blog, bucket, buckets, cdn, checkout, client, clients, console, coritan, dashboard, ddos, demo, dev, developer, developers, dns, docs, edge, example, ftp, game, games, git, help, hostmaster, imap, internal, invoice, invoices, jmap, legal, login, mail, minecraft, mobile, mta-sts, mx1, mx2, mx3, news, no-reply, noreply, ns1 to ns8, oauth, official, panel, pay, payment, payments, play, pop, pop3, portal, postmaster, privacy, proxy, register, root, secure, security, sftp, shield, shop, signin, signup, smtp, ssh, sso, staff, staging, static, status, storage, store, support, sys, system, terms, test, testing, verified, verify, vpn, waf, webmail, webmaster and www. Coritan can reserve more, and the API's rules.reserved lists every reserved name (With the API).

The name appears in Websites with a coritan.gg badge, and works like a domain you own. Forms that ask for a domain list your names beside Your names: or Under your name:, and selecting one fills in the field.

Use Example Page
Mailboxes you@alex.coritan.gg Add a domain to Mail Hosting
Mail sent through SMTP Relay alex.coritan.gg Add a sending domain to SMTP Relay
A website alex.coritan.gg or www.alex.coritan.gg Create a web proxy
A game server play.alex.coritan.gg Use your own domain for a join address
An instance's name vm.alex.coritan.gg Manage an instance's addresses and names
Reverse DNS for a floating IP mail.alex.coritan.gg Set reverse DNS for a floating IP
Records of your own Any record the zone takes Add, edit and delete DNS records

Coritan publishes the mail records for a claimed name itself, so a mail domain needs no DNS step (Mail DNS records). A join address can use a name under yours, such as play.alex.coritan.gg, but not the name itself.

Coritan's nameservers answer for the name, and it cannot use other nameservers or move to a registrar (Website settings). Coritan signs the zone with DNSSEC and publishes its DS records in coritan.gg, so DNSSEC needs no step from you (Set up DNSSEC). Coritan also requests a wildcard certificate, such as *.alex.coritan.gg, which covers the name and every name directly under it (How SSL/TLS certificates work).

Limit Value
Names an account can hold 3
Length of a name 3–32 characters
DNS zones an account can hold, claimed names included 100
Claims 6 an hour, for your account
Availability checks 60 a minute, for your account

Rate limits lists the budgets for every action.

Caution

Releasing a name deletes its DNS zone with every record, load balancer and origin pool in it. Mail domains, web proxies, certificates and game server addresses under the name stop working, and anyone can claim the name afterwards. You cannot undo a release.

  1. In the dashboard, go to Websites and open the name, such as alex.coritan.gg.
  2. Open the Settings tab.
  3. On the Release this name card, select Release name….
  4. Type the full name, such as alex.coritan.gg.
  5. Select Release name.

A release does not cancel a service that used the name, such as a mail service or a web proxy. Cancel the service as well when you no longer need it.

After a claim, the form shows Your new name and alex.coritan.gg is yours. Coritan has created the name's DNS zone, added its NS and DS records to coritan.gg and requested its wildcard certificate. Select a card to use the name at once: Add mailboxes, Point a website at it, Use it for a game server or Edit its DNS. Done closes the form.

After a release, the dashboard shows alex.coritan.gg released. and opens the Websites list, which no longer lists the name.

At least 3 characters
The name is shorter than 3 characters. Add to it.
Lowercase letters, digits and hyphens; not starting or ending with a hyphen
The name starts or ends with a hyphen. Remove it.
No double hyphens
The name has two hyphens in a row. Remove one.
That name is reserved
Coritan keeps the name back (Name rules). Choose another.
Already in use by a game server address
A join address uses the name. Choose another.
Already taken
Another account holds the name, or claimed it after the form checked it. Choose another.
Could not check the name: followed by a reason
The availability check failed. When the reason is Too many requests for this action. Please wait and try again., the account made 60 checks in the past minute. Wait a minute, then type the name again.
This account holds all 3 of its coritan.gg names. Release one from its Websites settings to claim another.
The account holds as many names as it can. Release one to claim another. Claim another name… is greyed out for the same reason.
Could not claim the name
Coritan refused the claim. The message under the title says why, and is one of the messages on this list.
You can claim up to 3 coritan.gg names
The account already holds 3 names. Release one first.
Zone limit reached (100)
The account already has 100 DNS zones, and a name needs one more. Delete a zone that you no longer use.
Too many requests for this action. Please wait and try again.
The account tried to claim a name 6 times in the past hour. Wait, then try again.
The new name does not resolve
The form said We are still finishing the delegation from coritan.gg. The name starts resolving when that is done. Coritan has not added the records in coritan.gg that point at your name. Contact support with the name if it still does not resolve.
coritan.gg is the platform's own domain; claim a name under it first
You entered coritan.gg itself in a form, such as a mail domain. Enter a name you hold, such as alex.coritan.gg, or a name under it.
Claim a coritan.gg name before using play.coritan.gg; it is not yours yet
The name you entered is under coritan.gg, but not under a name you hold. Claim the name first, or use one under yours, such as play.alex.coritan.gg.
Could not release the name
The release failed, and the message gives the reason. Try again, or contact support.
A name you did not release has gone
Coritan can take a name back after a trademark or abuse complaint, which deletes its zone as a release does. Contact support to ask why.

Read the domains on offer, your names, the rules and the reserved list with GET /client/platform-domains:

Shell
curl https://api.coritan.com/api/v1/client/platform-domains \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{
  "suffixes": ["coritan.gg"],
  "claims": [
    {
      "id": 17,
      "zone_id": 42,
      "suffix": "coritan.gg",
      "label": "alex",
      "fqdn": "alex.coritan.gg",
      "created_at": "2026-09-16T10:24:00",
      "zone_status": "active",
      "record_count": 6
    }
  ],
  "limit": 3,
  "remaining": 2,
  "rules": {
    "min_length": 3,
    "max_length": 32,
    "pattern": "^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?$",
    "reserved": ["abuse", "account", "accounts", "admin"]
  },
  "suggestions": {
    "web": "www.alex.coritan.gg",
    "mail": "alex.coritan.gg",
    "play": "play.alex.coritan.gg",
    "vm": "vm.alex.coritan.gg",
    "ip": "ip.alex.coritan.gg",
    "app": "app.alex.coritan.gg",
    "sftp": "sftp.alex.coritan.gg",
    "db": "db.alex.coritan.gg"
  }
}

The example shortens reserved, which lists every reserved name. id is the claim's ID, which the release and certificate calls take, and zone_id is the name's zone in the DNS API. remaining is null when an account can hold any number of names. suggestions proposes a name for each product under the first name you claimed, and is null while you hold none.

Check a name with GET /client/platform-domains/availability:

Shell
curl "https://api.coritan.com/api/v1/client/platform-domains/availability?label=alex" \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{"available": true, "fqdn": "alex.coritan.gg", "reason": null}

label takes 1–63 characters, or the call answers 422. suffix is the domain to claim under, and defaults to the first one in suffixes. The call turns capitals into lowercase letters and trims spaces, but changes nothing else, unlike the dashboard's field. A name you cannot claim answers "available": false with a reason: one of the messages in Troubleshooting, or Enter a name, At most 32 characters or That suffix is not offered. The check allows 60 calls a minute for your account.

Claim the name with POST /client/platform-domains/claims. The body takes label and, optionally, suffix:

Shell
curl -X POST https://api.coritan.com/api/v1/client/platform-domains/claims \
  -H "Authorization: Bearer $CORITAN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label": "alex"}'
JSON
{
  "zone_id": 42,
  "fqdn": "alex.coritan.gg",
  "label": "alex",
  "suffix": "coritan.gg",
  "created_at": "2026-09-16T10:24:00.412733+00:00",
  "parent_delegated": true,
  "dnssec": {"enabled": true, "ds_published": true},
  "certificate": {"domain": "*.alex.coritan.gg", "queued": true, "job_id": 90121, "reason": null}
}

The call answers 201. parent_delegated is false when Coritan could not yet add the name's NS records to coritan.gg, and the name does not resolve until it has. certificate.queued is false with a reason when Coritan did not request the wildcard certificate; request it again as Request the wildcard certificate again shows.

A refused claim answers with the reason as detail:

Status When
403 You can claim up to 3 coritan.gg names, or Zone limit reached (100).
409 Already taken or Already in use by a game server address.
422 The name breaks a rule, or That suffix is not offered.
429 The account sent 6 claims in the past hour (Rate limits).

Release the name with DELETE /client/platform-domains/claims/{claim_id}. The release deletes the zone and everything in it, as Release a name describes, and asks for no confirmation:

Shell
curl -X DELETE https://api.coritan.com/api/v1/client/platform-domains/claims/17 \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{"ok": true, "fqdn": "alex.coritan.gg"}

A claim ID that is not one of yours answers 404 Claim not found. Deleting the name's zone with the DNS API releases the name too (Delete a DNS zone).

Request the wildcard certificate again

Section titled Request the wildcard certificate again

Coritan requests the wildcard certificate when you claim a name. When that request did not go ahead, or the certificate order failed, request it again with POST /client/platform-domains/claims/{claim_id}/certificate:

Shell
curl -X POST https://api.coritan.com/api/v1/client/platform-domains/claims/17/certificate \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{"domain": "*.alex.coritan.gg", "queued": true, "job_id": 90188, "reason": null}

The call answers 202, and the name's SSL tab shows the certificate once it is issued. A claim ID that is not one of yours answers 404 Claim not found, and a claim whose zone is gone answers 409 The claim's zone no longer exists. When Coritan does not queue the request, the call answers 409 with the reason: already in progress while an earlier request for the name is still waiting, a reason that starts with Rate limit: when too many certificates were issued under coritan.gg in the past 7 days, or coritan.gg is not delegated to the platform's nameservers yet. Try again later.

API operations on this page