Manage an instance's addresses and names
See an instance's IP addresses, attach floating IPs, set reverse DNS and give the instance a name in your own domain.
In the dashboard
The Network tab shows the IP addresses that reach an instance, the floating IPs attached to it and the traffic it has used this month. From the tab you can also give the instance a name in one of your domains, set the reverse DNS of each address and put a web address in front of it.
Each instance comes with one IPv4 address, its primary address. More addresses are floating IPs that you order and attach.
Before you begin
Section titled Before you beginTo name the instance, you need a DNS zone on your account in Coritan DNS. That can be your own domain, as Add a domain you already own describes, or a free name under coritan.gg, as Claim a free coritan.gg name describes.
See the instance's addresses
Section titled See the instance's addressesIn the dashboard, go to Cloud Compute, open the instance and select the Network tab.
- Addresses
- Every address attached to the instance, primary first. Each row shows the Address with its version and prefix length, its Gateway, its Role and Since when it has been attached. The primary address shows
Primaryunder Role. Select Copy address to copy an address. - Floating IPs
- The floating IPs on your account that are attached to the instance, with their Region and Since date. Select an address to open it on the Floating IPs page, or Reverse DNS to open its reverse DNS.
- Interfaces
- The instance's virtual network cards. Each shows its MAC address, which Copy MAC address copies, and its model and port speed.
- Traffic
- How much the instance has sent and received this month, against its plan's allowance. How instance traffic is counted explains the figures.
Attach another address
Section titled Attach another address- On the Floating IPs card, select Attach floating IP. The Floating IPs page opens.
- Attach the floating IP to the instance, as Attach and detach a floating IP describes.
- Restart the instance from the header. The instance sets up the new address when it starts, as Start, stop and restart an instance explains.
The address then appears on the Addresses card. If you have no floating IP to attach yet, order one first.
Name the instance
Section titled Name the instanceThe Name this instance card gives the instance a hostname in a zone you hold, such as vm.example.com. It writes an A record for each IPv4 address and an AAAA record for each IPv6 address attached to the instance.
- On the Network tab, find the Name this instance card.
- Under Hostname, type the full name, such as
vm.example.com. If you hold a coritan.gg name, the field already holds a name under it, and selecting one of the names listed under the field fills it in. - Leave Set reverse DNS to match ticked to set the same name as the reverse DNS of the primary address. Mail servers expect it there.
- Leave Set the guest hostname too unticked. The request fails with it ticked, because the instance's hostname cannot hold dots. To change the hostname inside the instance, use the Access tab, as Change the hostname describes.
- Select Name this instance.
The card confirms which records it wrote. Records the name already had stay in the zone, so remove any that point elsewhere on the zone's DNS page, as Add, edit and delete DNS records describes. We write the new records with a TTL of 300 seconds.
Set reverse DNS
Section titled Set reverse DNSReverse DNS is the name a lookup of an address returns. Mail servers compare it with the name your mail server gives when it connects, so set it on any address that sends mail. Set it to a name that resolves back to the same address.
- On the Reverse DNS card, find the address and select Edit.
- Type the full name, such as
mail.example.com. - Select Save.
The card shows the new name next to the address. The name must be a full domain name with at least one dot.
Put a web address in front of the instance
Section titled Put a web address in front of the instanceThe Web address card creates a web proxy for a site on the instance. The proxy answers at a hostname you choose and forwards the requests to port 80 of the primary address, with HTTPS and the WAF in front.
- On the Web address card, type the Hostname, such as
www.example.com. - Leave Request an HTTPS certificate ticked to get a certificate for the name.
- Select the button under the form, "Give this instance a web address".
When we host the name's zone, we write its DNS record for you. The card then lists the web address with Manage route, which opens it on the Edge Proxy page. Create a web proxy covers the options.
Result
Section titled ResultThe Addresses card lists each address on the instance, the name you chose resolves to the instance's addresses, and the Reverse DNS card shows the name each address answers with.
Troubleshooting
Section titled TroubleshootingNo addresses yet- The instance has no address attached. Attach a floating IP, then restart the instance from the header.
- A new address does not answer
- The instance sets up addresses when it starts. Restart it from the header, as the steps above describe. A
reboottyped inside the instance does not set them up. Enter a full hostname inside a zone you hold, such as vm.example.coritan.gg.- Type the whole name, including the domain, such as
vm.example.com. Use a name inside a domain you hold here, or claim a platform name first- The name is not inside a DNS zone on your account. Add the domain to Coritan DNS, or claim a coritan.gg name, then try again.
Invalid hostname- Set the guest hostname too was ticked, and nothing was saved. Untick it and select Name this instance again.
- A message that ends
is a CNAME; pick another name or remove that record first - The name already has a
CNAMErecord, which cannot sit beside anArecord. Choose another name, or delete theCNAMErecord in the zone first. This instance has no address yet- Attach an address to the instance before you name it.
Could not set reverse DNS: PTR hostname must be a fully-qualified domain name- Type a full name with a domain, such as
mail.example.com, not a single word. - A reverse lookup still returns the old name
- Resolvers can keep the old answer for a few minutes. If the old name stays for longer, contact support with the address.
Related
Section titled Related- Floating IPs covers ordering, attaching and moving addresses.
- Set reverse DNS for a floating IP sets reverse DNS from the Floating IPs page, including the hosts of a subnet.
- How instance traffic is counted explains the Traffic card.
- How DNS hosting works explains the zones the name goes in.
With the API
Section titled With the APIGET /api/v1/client/vps/{uuid}/ips lists the addresses attached to the instance, primary first. Each has the address, prefix_len, subnet_mask, gateway, is_primary, attached_at, role, status, and the ip_service_id of the floating IP it belongs to. role is standalone for a single address and host for an address from a subnet.
GET /api/v1/client/vps/{uuid}/ptr returns the reverse DNS of every attached address as items. Each item has the address, is_primary and hostname, which is null when the address has none.
PATCH /api/v1/client/vps/{uuid}/ptr sets the reverse DNS of one address. Send hostname, and address to choose an address other than the primary one:
curl -X PATCH https://api.coritan.com/api/v1/client/vps/$INSTANCE_UUID/ptr \
-H "Authorization: Bearer $CORITAN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"hostname": "mail.example.com", "address": "203.0.113.10"}'
It answers with the address and its new hostname. A name that is not a full domain name answers 422 with a message that starts PTR hostname. An instance with no address answers 404 with This instance has no address to name, and an address that is not on the instance answers 404 with That address is not attached to this instance.
POST /api/v1/client/vps/{uuid}/name names the instance. Send the full hostname, from 3 to 253 characters. set_ptr is true when left out. Leave set_hostname out: with a full name it answers 400 with Invalid hostname and saves nothing. To set the hostname inside the instance, use PATCH /api/v1/client/vps/{uuid}/hostname, as Manage an instance's password, SSH keys and hostname describes.
curl -X POST https://api.coritan.com/api/v1/client/vps/$INSTANCE_UUID/name \
-H "Authorization: Bearer $CORITAN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"hostname": "vm.example.com", "set_ptr": true}'
{
"hostname": "vm.example.com",
"zone": "example.com",
"records": [{"type": "A", "content": "203.0.113.10"}],
"ptr": {
"id": 9,
"inventory_id": 41,
"hostname": "vm.example.com",
"address": "203.0.113.10",
"version": "ipv4",
"service_id": 118,
"created_at": "2026-09-25T10:00:00",
"updated_at": "2026-09-25T10:00:00"
}
}
records lists only the records the request created. ptr is the primary address's reverse DNS record, or null when you send "set_ptr": false. A name outside your zones answers 403, an instance with no address answers 409 with This instance has no address yet, and a name that holds a CNAME answers 409.
The Cloud Compute API reference lists every field.
API operations on this page
| Method | Path | What it does |
|---|---|---|
GET | /api/v1/client/vps/{uuid}/ips | Get instance IPs |
GET | /api/v1/client/vps/{uuid}/ptr | Reverse DNS of every address attached to the instance |
PATCH | /api/v1/client/vps/{uuid}/ptr | Set the reverse DNS of one attached address (the primary by default) |
POST | /api/v1/client/vps/{uuid}/name | Name instance |