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
Routers connect subnets within your project and provide external gateway access for floating IP NAT and outbound internet connectivity. Each router can connect multiple subnets and optionally attach to an external network for public access.Prerequisites
- An active Xloud account with appropriate permissions
- Access to the Xloud Dashboard or CLI configured with credentials
- API credentials sourced (
source openrc.sh)
Create a Router
- Dashboard
- CLI
Configure the router
| Field | Type | Required | Description |
|---|---|---|---|
| Name | Text | Yes | Router display name |
| Description | Text area | No | Optional notes |
| Availability Zone Hints | Multi-select table | No | Pin to specific availability zones |
| Options: Open External Gateway | Checkbox | No | Toggle to attach an external gateway |
| External Gateway | Select table | Required if gateway enabled | Choose the provider/public network for internet access |
View Routers
- Dashboard
- CLI
Navigate to Network > Routers. The list shows:
Filter by Name or Status.
| Column | Description |
|---|---|
| ID/Name | Router identifier (clickable to view details) |
| Status | Active or Error |
| Open External Gateway | Whether an external gateway is attached (Yes/No) |
| External Network | Name of the external network (with link) |
| External Fixed IP | IP address on the external network |
| Created At | Creation timestamp |
Manage Router Interfaces
- Dashboard
- CLI
Click a router name to open the detail page. The Interfaces tab shows all
connected subnets and ports.
Connect a Subnet: Click the More dropdown on the router row and select
Connect Subnet. Choose the subnet to attach.Disconnect a Subnet: Click the More dropdown and select
Disconnect Subnet. Choose the subnet to remove.
| Column | Description |
|---|---|
| Port ID | Interface port identifier |
| Bind Resource | Instance link (if applicable) |
| Owned Network | Network this interface belongs to |
| MAC Address | Hardware address |
| Status | Active or Down |
Manage External Gateway
- Dashboard
- CLI
From the router row’s More dropdown:
| Action | When Available | Description |
|---|---|---|
| Set Gateway | No external gateway attached | Attach an external network |
| Close Gateway | External gateway attached | Remove the external gateway |
| Enable SNAT | Gateway attached, SNAT disabled | Enable source NAT for outbound traffic |
| Disable SNAT | Gateway attached, SNAT enabled | Disable source NAT |
Delete a Router
- Dashboard
- CLI
Click the More dropdown on the router row and select Delete.
All subnet interfaces must be disconnected before a router can be deleted.
Disconnect all subnets first, then delete the router.
Next Steps
Floating IPs
Allocate public IPs and associate them with instances via this router
Create a Network
Provision networks and subnets to connect to this router
Security Groups
Control traffic with per-port firewall rules
VPN
Create IPsec site-to-site VPN tunnels through this router