Skip to main content

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

1

Navigate to Routers

Navigate to Network > Routers in the sidebar. Click Create Router.
2

Configure the router

FieldTypeRequiredDescription
NameTextYesRouter display name
DescriptionText areaNoOptional notes
Availability Zone HintsMulti-select tableNoPin to specific availability zones
Options: Open External GatewayCheckboxNoToggle to attach an external gateway
External GatewaySelect tableRequired if gateway enabledChoose the provider/public network for internet access
Selecting an external network sets the router’s default gateway and enables NAT for floating IP allocation. Leave unchecked for purely internal routing between project subnets.
3

Create the router

Click Confirm. The router appears in the list.
Router shows status Active with the external gateway (if configured).

View Routers

Navigate to Network > Routers. The list shows:
ColumnDescription
ID/NameRouter identifier (clickable to view details)
StatusActive or Error
Open External GatewayWhether an external gateway is attached (Yes/No)
External NetworkName of the external network (with link)
External Fixed IPIP address on the external network
Created AtCreation timestamp
Filter by Name or Status.

Manage Router Interfaces

Click a router name to open the detail page. The Interfaces tab shows all connected subnets and ports.
ColumnDescription
Port IDInterface port identifier
Bind ResourceInstance link (if applicable)
Owned NetworkNetwork this interface belongs to
MAC AddressHardware address
StatusActive or Down
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.

Manage External Gateway

From the router row’s More dropdown:
ActionWhen AvailableDescription
Set GatewayNo external gateway attachedAttach an external network
Close GatewayExternal gateway attachedRemove the external gateway
Enable SNATGateway attached, SNAT disabledEnable source NAT for outbound traffic
Disable SNATGateway attached, SNAT enabledDisable source NAT

Delete a Router

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