Overview
Routers are Layer 3 devices that route traffic between tenant subnets and provide external gateway connectivity via NAT. Each router can be attached to one external network — which enables outbound internet access and floating IP allocation — and to multiple tenant subnets via internal interfaces.Prerequisites
- At least one tenant network with a subnet (Create a Network)
- An external or provider network available in your cluster (provisioned by your administrator)
- Dashboard access or CLI configured with valid credentials
Create a Router
- Dashboard
- CLI
Navigate to Routers
Log in to the Xloud Dashboard (
https://connect.<your-domain>) and navigate to
Project → Network → Routers. Click Create Router.Configure the router
| Field | Value | Description |
|---|---|---|
| Router Name | e.g., main-router | Display name |
| Enable Admin State | Checked | Allow the router to forward traffic |
| External Network | Select your provider/public network | Sets the default gateway and enables floating IP NAT |
Selecting an external network sets the router’s default gateway and enables
NAT for floating IP allocation. Leave blank for purely internal routing.
Add an interface
After creation, open the router and click the Interfaces tab, then
Add Interface:
Repeat this step for each subnet that should be routable through this router.
| Field | Value |
|---|---|
| Subnet | Select the subnet to attach (e.g., app-subnet) |
| IP Address | Optional — leave blank to auto-assign the gateway IP |
Each interface appears with status Active.
Manage Router Interfaces
Add an Interface
Add interface to router
Remove an Interface
Remove interface from router
Update the External Gateway
- Dashboard
- CLI
Open the router, click Edit Router, and update the External Network field.
Static Routes
Add static routes to a router to direct traffic for specific prefixes through a custom next-hop — useful for hybrid connectivity or VPN integration.Add static route to router
Remove static route from router
Validation
- Dashboard
- CLI
Navigate to Project → Network → Routers and confirm:
- Status: Active
- Admin State: Up
- External Network: Populated with your provider network
- Interfaces: Lists all attached subnets
The router is operational. Instances on attached subnets can reach the internet through NAT.
Next Steps
Floating IP Addresses
Allocate public IPs and associate them with instances behind your router
Network Topologies
Visualize and design multi-tier network topologies
L3 Router Configuration
Enable HA routers and distributed virtual routing for production deployments
Network Troubleshooting
Diagnose floating IP and routing connectivity issues