Documentation Index
Fetch the complete documentation index at: https://docs.xloud.tech/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Floating IPs provide external access to instances running on private networks. A floating IP maps a publicly routable address to an instance’s private port via NAT on the router. You can associate, disassociate, and reassign floating IPs without downtime.Prerequisites
- An active Xloud account with appropriate permissions
- Access to the Xloud Dashboard or CLI configured with credentials
- API credentials sourced (
source openrc.sh)
A router with an external gateway must be connected to the instance’s network before
floating IPs can be associated. See Routers.
Allocate a Floating IP
- Dashboard
- CLI
Configure the allocation
| Field | Type | Required | Description |
|---|---|---|---|
| Network | Dropdown | Yes | Select the external network to allocate from |
| Owned Subnet | Dropdown | No | Optionally select a specific subnet within the external network |
| Floating IP Address | Text | No | Request a specific IP (shown after subnet selection, when not batch) |
| Description | Text area | No | Label the IP’s intended use |
| Batch Allocate | Checkbox | No | Toggle to allocate multiple IPs at once |
| Count | Number | If batch enabled | Number of IPs to allocate (default: 2) |
Administrators see an additional Project selector to allocate IPs
for other projects. If QoS is enabled on the platform, a QoS Policy
selector also appears for all users.
View Floating IPs
- Dashboard
- CLI
Navigate to Network > Floating IPs. The list shows:
| Column | Description |
|---|---|
| ID/Floating IP | The allocated public address (clickable to view details) |
| Description | Optional description text |
| Associated Resource | Instance or port bound to this IP (if associated) |
| Status | Available, Pending, Active, Error, or Down |
| Created At | Allocation timestamp |
Associate with an Instance
- Dashboard
- CLI
Open the Associate dialog
On the floating IP row, click Associate (available when status is
Down or Available).Disassociate a Floating IP
- Dashboard
- CLI
On the floating IP row, click Disassociate (available when status is
Active).
Confirm the action. The IP returns to Down status and can be reassigned.Release a Floating IP
- Dashboard
- CLI
Click the More dropdown on the floating IP row and select Release.
The IP is returned to the external network pool.
Releasing a floating IP is permanent. If you release a static IP that DNS
records or external systems reference, those references will break immediately.
Next Steps
Routers
Set up the external gateway required for floating IP routing
Security Groups
Allow inbound traffic on the floating IP’s port
Create a Network
Provision the internal network for your instances
Launch an Instance
Create an instance to associate the floating IP with