Skip to content
Coritan Docs

Floating IPs

Hold public IPv4 and IPv6 addresses and IPv4 subnets on your account, attach them to instances and servers, and find each instance's IPv6 /64.

View as Markdown

A floating IP is a public IP address that belongs to your account instead of to one machine. You attach it to a Cloud Compute instance or a server on App Deployment, and you can move it to another one later while the address stays the same. A floating IP is a single IPv4 address, a single IPv6 address, or a subnet, a block of IPv4 addresses whose hosts you attach one at a time. An IPv6 address attaches to Cloud Compute instances only.

Use a floating IP when an address has to outlast the machine behind it, such as a mail server whose reverse DNS you want to keep or a game server address your players have saved.

In the dashboard, go to Floating IPs. The list shows every single address, subnet and instance IPv6 /64 on your account, and each one is a card. Order floating IP at the top orders one, as Order a floating IP describes. While a search or filter is on, a line under the heading says how many floating IPs match, such as "2 of 7".

The IPv4 address that comes with a Cloud Compute instance is a floating IP too, so it is on the list. It ends when the instance ends. The list also holds the IPv6 /64 of each instance that has one: a block of IPv6 addresses that comes with the instance at no charge, as Add IPv6 to an instance describes. The /64 belongs to its instance. It has no Attach, Detach or cancel, and it ends when the instance ends.

Four tiles sit above the list. Each one is also a filter: select it to show those floating IPs, and select it again to turn the filter off. On a phone, a tile shows only its figure.

  • Floating IPs counts every address, with what they are in its footer, such as "3 addresses, 1 subnet, 1 IPv6 /64". Selecting it clears every filter and the search.
  • Attached counts the floating IPs that something uses. A subnet counts as attached while one of its hosts is attached. Its footer reads "In use", or "2 not active" when floating IPs are not active yet.
  • Unattached counts the active floating IPs that nothing uses. Its footer says how many of them still bill, such as "2 still bill" or "1 still bills", and reads "None bill" when none does and "Nothing idle" when there are none.
  • Needs attention counts the floating IPs with something to fix. It turns red while the count is above zero. Its footer reads "Payments, setup and delivery", or "Nothing to fix".

A floating IP needs attention when it is suspended or failed, when the server did not take it, or when its order waits for payment:

Problem on the list Button What it means
This floating IP is suspended. Pay its overdue invoice to use it again. Open Billing The floating IP's service is suspended, and the button opens its Billing tab.
We could not set this up. Contact support and we will look into it. Contact support Setup failed.
The server did not take this address. Open Attach to detach it and try again. Open Attach An active floating IP that is attached to a server did not reach the server's host.
Waiting for payment. We set it up as soon as you pay. Open Billing The floating IP's service is pending and costs something. The button opens the Subscriptions tab of Billing.

Suspended and failed are the two states that the Floating IPs item in the sidebar counts as well.

Three things are a calm note on the card and are not a problem. They do not count under Needs attention, show in the strip or turn the card red:

  • A floating IP that is being set up says "We are setting this up. This usually takes under a minute."
  • A floating IP on its way out says "This floating IP is ending."
  • An active address that nothing uses and that still bills says "Not attached to anything, and it still bills." with an Attach button. A subnet with no host in use says "No host uses this block, and it still bills." with Open hosts. The Unattached tile counts how many still bill. An address that costs nothing, such as one your account plan pays for, has no note (When your account plan pays for it).

When a floating IP needs attention, a strip under the tiles says "3 floating IPs need attention", or "1 floating IP needs attention". It lists up to three, or one on a phone, each with its address, its first problem and the button that fixes it, the worst first: suspended and failed, then delivery failures and orders that wait for payment. Show all and the number of floating IPs filters the list to all of them. The strip is for the full list, so it is hidden while any filter or search is on.

The toolbar narrows and orders the list:

  • The search box, "Search address, region or server", finds a floating IP by its address, region, pool, the name of what it is attached to, or its number. It does not search reverse DNS names, because the list does not show them.
  • The Show menu holds All floating IPs, Attached, Unattached, Not active and Needs attention, each with a count. Not active holds every floating IP that is not active yet: one that waits for payment or setup, and one that is suspended, failed or ending.
  • The Sort by menu holds Newest first (the default), Address, lowest first, Region and Problems first. Address, lowest first sorts by number: IPv4 before IPv6, so 51.89.6.200 comes before 51.89.44.8, and a floating IP with no address yet comes last. Region puts floating IPs of one region together, lowest address first. Problems first uses the order of the strip. Floating IPs that tie stay newest first. In the table, selecting a column heading sorts by it, and the menu then names that column, such as "Sort: Status".
  • Clear filters appears while Show or the search is on, and turns them off.
  • Cards and Table switch how the list looks, and Refresh reads the list again. Your choice of cards or table stays in your browser. A phone always shows cards and has neither control.

The search, Show, the sort and the page stay in the address, so a reload or a shared link brings them back. The address words are q, status (attached, unattached, pending or attention; pending is the Not active choice), sort (address, region or attention, and none for Newest first) and page.

The list shows 24 floating IPs a page. When there are more, page buttons appear below it. A search or filter that matches nothing says "No matches", with Reset filters. When Refresh fails and the list is on screen, a warning reads Could not refresh your floating IPs, with Try again, and the list stays as it was. A line under the list says that orders waiting for payment are on the Subscriptions tab of Billing, and links there.

A card shows the address with its prefix length, such as 203.0.113.10/32, or "Floating IP #214" while setup has not given it an address. Next to it is a badge: Attached, Unattached, Pending, Suspended, Failed or Ending. Pending is a floating IP that waits for payment or setup, or has no address yet. The line under the address says what it is, "IPv4 address", "IPv6 address", "Subnet block" or "IPv6 /64", then the region, such as "London (LHR)". Under them, a red or amber line says each problem from the table above, up to two, or a calm line for one of the notes above. Facts follow:

Fact What it says
Attached to The instance or server the address is attached to, as a link. A subnet reads "2 of 5 hosts" with "3 free" under it. A /64 reads "Comes with" and its instance. An address that nothing uses reads "Not attached", in amber while it still bills.
Region The region the floating IP is in.
Price What the next renewal costs, such as $2.00/mo, with "Renews Oct 1, 2026" under it while the floating IP is active. A /64 reads "Included with the instance", and an address your account plan pays for reads "Paid by your plan".
Since The date the floating IP began.

The card does not show the reverse DNS name. Open the floating IP and select its Reverse DNS tab to read or set it (Set reverse DNS for a floating IP).

The footer of a card holds these controls:

  • A button for each problem, two at most: Open Billing, Contact support or Open Attach.
  • The one thing you do most with the floating IP: Detach… for an attached address, Attach for an unattached one and Open hosts for a subnet. This is the button of the note for an address that still bills. Detach… opens a question that names the address, "Detach 203.0.113.10/32?", and Detach address confirms it. A card has no second copy of a button that a problem already shows, such as Open Attach. A /64, and a floating IP that is not active yet, has none of them.
  • The ... menu, named "More actions for" and the address. It opens the floating IP's tabs: Overview, Attach, Reverse DNS, Hosts for a subnet, Shield and Billing. On an attached address, Attach reads Move to another server and opens the same Attach tab. A /64 has no Attach. A floating IP that has no address yet, or is not active, has only Overview and Billing. Copy address copies the address, and Detach… appears here for an attached address whose main button is not Detach….

Select a card to open the floating IP (Open a floating IP).

Table shows one row for each floating IP:

Column What it says
Address The address with its prefix length, with "Subnet" and the number of usable hosts under a subnet, or "IPv6 /64" under a /64.
Version IPv4 or IPv6. A narrow window hides it.
Region The region.
Prefix The prefix length, such as /32. A narrow window hides it.
Attached to What the floating IP is attached to, as on the card.
Reverse DNS Per host for a subnet, Per address for a /64, and a dash for a single address, because the list does not read the name. Select the column's help tip for what reverse DNS is. A narrow window hides it.
Status The badge, with the first problem's short label under it when it says more than the badge: "Setup failed", "Delivery failed" or "Waiting for payment".

The last column is the ... menu from the card. Select a row to open the floating IP. Select the heading of Address, Version, Region, Prefix, Attached to or Status to sort by it.

While you have no floating IP, the page says No floating IPs yet and shows a card, Order floating IP: "Choose a location and a size, then attach the address to an instance or a server." The header's Order floating IP does the same.

Select a card or a row to open the floating IP. The header shows the address, its badge, whether it is an IPv4 address, an IPv6 address, an IPv6 /64 or a Subnet block, its region and what it is attached to. A /64 shows Comes with and its instance, and its panel has no Attach tab. Copy address copies the address.

The Overview tab opens first. When a single address is not attached to anything, the tab starts with Not attached to anything yet and a link to attach it. A /64 starts with Part of the instance, which says that the /64 stays with its instance, costs nothing and ends when the instance ends.

Address
The address or subnet, its Version, Prefix, Region and Pool, and its Gateway when it has one. A single address shows what it is Attached to, Attached since and, on an instance, its Role on instance: Primary address or Additional address. An IPv6 address is always an Additional address. A subnet shows Hosts: how many of its usable hosts are attached and how many are free. A /64 shows its Network, the instance it Comes with, and the Instance address, the address in the /64 that the instance uses, which ends in ::1. Reverse DNS shows the address's hostname, or Set reverse DNS when it has none. A subnet shows Per host there and a /64 shows Per address, and both open the Reverse DNS tab.
Service
The service that bills for the floating IP: its Status, Product, Price, Next renewal, when it was Ordered, and its Service ID. A /64 shows Added in place of Ordered. Open Billing opens the Billing tab.
Tags
Labels to find the floating IP by, as Tag your services describes.
Protection
A reminder that DDoS Shield filters traffic to the address. Open Shield opens the Shield tab.

Get an address:

Use it:

Pay for it and fix problems:

The public Floating IPs page describes the product, with its prices from the catalogue. The order page shows the sizes and regions you can actually order.

Each floating IP is a service of its own, on the plan and billing cycle you order it on. A single IPv4 address costs nothing while it is the primary address of a Cloud Compute instance. Anywhere else it bills at its plan's price: while it is unattached, as an additional address on an instance, or on a server. An IPv6 address is never an instance's primary address, so it always bills at its plan's price. A subnet always bills at its plan's price too. The IPv6 /64 that comes with an instance costs nothing.

Your account plan also pays for some single IPv4 addresses: 1 on Pro, 2 on Business and 10 on Enterprise. Each address it pays for costs nothing, attached or not (When your account plan pays for it). The plan never pays for an IPv6 address.

Cancel a floating IP explains how the price follows the address. Billing covers invoices, credit and payment.

  • You can order a single IPv4 address, a single IPv6 address, or an IPv4 subnet from /29 to /24, where the order page offers one. An IPv6 address is a /128, and we sell no IPv6 subnets. Fewer regions sell IPv6 than IPv4.
  • An IPv4 floating IP attaches to a Cloud Compute instance or a server on App Deployment. An IPv6 address attaches to Cloud Compute instances only.
  • A single address attaches to one instance or server at a time. Each host of a subnet attaches on its own, so different hosts can go to different targets.
  • A server holds one floating IP. An instance can hold several, and one IPv4 address is its primary address. An IPv6 address is never the primary address.
  • An instance in a location with IPv6 holds one IPv6 /64 at no charge. You cannot detach it or move it, and it ends with the instance.
  • DDoS Shield filters traffic to every floating IP on your account, attached or not, and to each instance's /64.

GET /api/v1/client/ips lists the floating IPs on your account, newest first, as items with a total.

Shell
curl https://api.coritan.com/api/v1/client/ips \
  -H "Authorization: Bearer $CORITAN_TOKEN"
JSON
{
  "items": [
    {
      "service_id": 214,
      "service_status": "active",
      "amount": 4.0,
      "billing_cycle": "monthly",
      "next_due_date": "2026-10-25T00:00:00",
      "kind": "standalone",
      "address": "203.0.113.10",
      "cidr": "203.0.113.10/32",
      "version": "ipv4",
      "prefix_len": 32,
      "inventory_status": "assigned",
      "pool_id": 4,
      "pool_name": "Frankfurt 1",
      "region": "fra",
      "geo_label": "Frankfurt",
      "target_type": "vps",
      "target_service_id": 118,
      "attached_at": "2026-09-25T10:00:00",
      "is_primary": 1
    }
  ],
  "total": 1
}

Use service_id in every other floating IP request. kind is standalone for a single address, block for a subnet and routed for an instance's IPv6 /64. version is ipv4 or ipv6. prefix_len is 32 for a single IPv4 address, 128 for an IPv6 address and 64 for a /64. inventory_status is assigned once the address is yours to attach. amount is what the next renewal costs.

For a single address, target_type is vps for an instance or container for a server, and target_service_id is that service's ID. Both are null when the address is not attached. is_primary is 1 when the address is its instance's primary address, and never for an IPv6 address. On a server, host_state and host_error say whether the address reached the server's host.

A routed row names the instance it comes with in the same fields, with target_type set to vps. Its address is the network and its cidr the whole /64, such as 2001:db8:1000:5::/64, and its amount is 0.0.

A subnet has null in the attachment fields. It carries hosts, one entry for each address in the block, and the counts hosts_total, hosts_attached and hosts_available, as How subnets work describes.

GET /api/v1/client/ips/{service_id} returns one floating IP with the same fields. A service that is not a floating IP on your account answers 404 with IP service not found.

The Floating IPs API reference lists every field.

API operations on this page

MethodPathWhat it does
GET/api/v1/client/ipsList account-owned floating IP / subnet services and attachment state
GET/api/v1/client/ips/{service_id}Get my IP