Skip to main content

VPC Static Routes

A static route tells your VPC where to send traffic for a remote network. Customers manage VPC-level static routes from the VPC details page in CMP.

Customer path: Networking → Networks → open a VPC → Static Routes

VPC Static Routes vs Private Gateway routes

Use VPC Static Routes when you need custom routing inside a VPC without using a Private Gateway route.

Route typeManaged in CMP
VPC Static RoutesVPC details → Static Routes tab
Private Gateway Static RoutesVPC details → Private Gateway tab

What you configure​

FieldDescriptionExample
CIDRDestination network for the route10.50.0.0/24
Next HopIP address that should receive traffic for that destination10.1.1.50
TagsOptional key/value labels to identify and organize routesenv = prod

Requirements​

CloudStack version

VPC Static Routes in CMP require CloudStack 4.21 or later.

View static routes​

The Static Routes tab lists routes configured for the VPC.

Screenshot: CMP — VPC Static Routes list

Each route shows:

ColumnDescription
CIDRDestination network
VPC Gateway IPVPC gateway address associated with the route (when applicable)
Next HopNext-hop IP address
ActionRow actions (for example edit, tags, delete)

Use the search bar and refresh control to filter or reload the list.

Create a static route​

  1. Open the VPC → Static Routes
  2. Click + Add Static Route
  3. Complete the form and click Add

Screenshot: CMP — Add Static Route modal

CIDR

Required. The destination network for the route.

Example: 10.50.0.0/24

Next Hop

Required. The IP address to which traffic for the specified destination network should be forwarded.

Example: 10.1.1.50

Click Add to create the route in CloudStack through CMP.

Tags​

Tags are optional and can be used to identify and organize static routes.

  1. Open the route Action menu → Manage Tags (or equivalent)
  2. Enter Key and Value
  3. Click Add Tag

Screenshot: CMP — Manage Tags on a static route

Key

Required when adding a tag. Tag name — for example, environment.

Value

Required when adding a tag. Tag value — for example, production.

Example tag: env = prod

Added tags appear on the route and can be removed from the same dialog.

Important notes​

RuleDetail
CloudStack versionRequires CloudStack 4.21+
CIDR overlapThe CIDR must not overlap with another static route in the same VPC
ScopeVPC Static Routes are managed at the VPC level
Private GatewayPrivate Gateway Static Routes are managed under Private Gateway, not on this tab
When to use VPC static routes

Use VPC Static Routes for custom routing to remote networks that should be handled at the VPC virtual router — for example, directing a subnet to an internal next-hop IP — without configuring a Private Gateway static route.