For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/bare-metal-cloud/dedicated-servers/configuring-the-vrack-between-the-public-cloud-and-a-dedicated-server.md.
  • English

Configuring the vRack between the Public Cloud and a Dedicated Server

View as Markdown

Learn how to configure private networking between a Public Cloud instance and a Dedicated Server.

The OVHcloud vRack allows you to configure private network addressing between two or more OVHcloud Dedicated Servers. But it also allows you to add Public Cloud instances to your private network so that you can create an infrastructure of both physical and virtual resources.

 

Requirements

OVHcloud Control Panel Access

Warning

NOTE: This feature might be unavailable or limited on servers in the Eco product line.

Please visit our comparison page for more information.

 

Instructions

Add a Public Cloud project to the vRack

Info

This does not apply to newly created projects, which are automatically delivered with a vRack. Once the project has been created, you can view the vRack by opening the Network menu in the left-hand sidebar and selecting vRack Private Network.

You can also remove the project from its allocated vRack and attach it to another vRack if you wish, particularly if you already have an existing vRack with your dedicated server(s).

From the vRack section of OVHcloud Control Panel, select the vRack you wish to use.

From the list of eligible services, choose the Public Cloud project you want to add to the vRack and then click Add.

Configuring the vRack between the public cloud and a dedicated server

 

Integrating an instance into the vRack

This guide focuses on a simple vRack configuration between a Public Cloud instance and a dedicated server. If you have set up your instance(s) with a local zones deployment mode, note that local zones do not support the vRack for now. Additionally, the vRack is a global L2 network and does not support "zone" or "region" level resilience.

Two situations may arise:

  • The instance does not exist yet.
  • The instance already exists, and you must attach a private network to it.

If using a new instance

If you need assistance, follow our Creating and Connecting a Public Cloud Instance guide. When creating an instance, you can choose to connect your instance to a specific private network. Choose your previously created vRack from the drop-down menu.

 

In case of an existing instance

Choose your Public Cloud Project, then navigate to the Private Network section.

Create a new Private Network, taking note of the following settings:

  1. The region for your Private Network must be the same as that of your instance.

  2. For both services to communicate with each other, they have to be tagged with the same VLAN ID.

    Info

    By default, the VLAN ID for dedicated servers is 0. To use this VLAN ID for an instance, it will be necessary to tag the private network with VLAN 0 as well. Tick the Set a VLAN ID box and select VLAN ID 0.

    If you do not tick the box, the system will assign a random VLAN ID to your private network.

    If you do not intend to use VLAN ID 0...

    If you do not intend to use VLAN ID 0, you may select a different ID between 1 and 4000. In this case:

    • When configuring the vRack on the dedicated server, this VLAN ID must be included in the network configuration file(s).
    Info

    It is possible to use the same VLAN ID for multiple private networks; however, this requires careful management of private IP addresses. Using non-overlapping DHCP pool allocations is one way to resolve this issue.

    Info

    Unlike dedicated servers (when you use a VLAN ID other than 0), there is no need to include the VLAN ID directly in the Public Cloud instance's network configuration file once it has been defined in the OVHcloud Control Panel.

    Example: if the private network of the instance is tagged with VLAN 2, this VLAN ID must be included only in the network configuration of the dedicated server. For further information, please consult the following guide: Create multiple VLANs in the vRack.

  3. You can keep the default private IP range or use a different one.

    Select "Enable DHCP for this private network" to automatically assign and configure the private IP address on the instance. You will then only need to configure the dedicated server’s network interfaces.

    When this option is not selected, manual configuration is required on both the Public cloud instance and the dedicated server.

    Make sure both Network Gateway options are unchecked.

Once done, click on Configure your private network. This will take a few minutes.

In the dashboard of the instance concerned, locate the "Networks" section and click the more options ⋮ button next to "Private networks". Select Attach a network.

In the pop-up window, select the private network(s) to attach to your instance and click on Confirm.

 

Configure your network interfaces

Info

If you chose the option to configure the private network on your instance using DHCP, you only need to configure the network interfaces on the dedicated server.

Configuration when using the default VLAN ID 0

Before you begin, connect to your server via SSH and list your network interfaces with the following command:

ip a

For dedicated servers, locate the line that begins with link ether and verify that this interface matches the Private interface listed in the Network interfaces tab of your server’s dashboard.

Use this interface name to replace NETWORK_INTERFACE in the configurations below (example: eth1).

For example purposes, we will use the IP address range of 192.168.0.0/16 (Subnet mask: 255.255.0.0).

From here, please refer to the Configuration examples section of our Configuring the vRack on your dedicated servers guide.

 

Configuration when using a different VLAN ID

In this example, we'll use 10 as the VLAN ID (tag), and 192.168.0.0/16 as the private IP address range.

Debian 11
Ubuntu / Debian 12+
AlmaLinux and Rocky Linux (8 & 9)
Fedora 42+ / AlmaLinux and Rocky Linux 10
Windows

The configuration below is based on Debian 11 (Bullseye).

  • Before you begin, establish an SSH connection to your server and run the following commands to install the VLAN package:

    sudo apt update
    sudo apt install vlan
  • Next, load the 8021q kernel module:

    sudo modprobe 8021q
  • To verify that the module is loaded:

    user@server:~$ lsmod | grep 8021q
    8021q                  40960  0
    garp                   16384  1 8021q
    mrp                    20480  1 8021q
  • Run the following command to ensure the modules are permanently loaded at boot:

    sudo su -c 'echo "8021q" >> /etc/modules'
  • Retrieve the interface names and identify the private interface:

    ip a

In this example, the private network interface is identified as eno2.

  • Next, create a VLAN subinterface for the network interface (non-persistent configuration) and assign (tag) it the VLAN ID. In this example, the VLAN ID is 10.

    Replace the values with your own.

    sudo ip link add link eno2 name eno2.10 type vlan id 10
  • Next, assign a private IP address to the newly created VLAN subinterface:

    sudo ip addr add 192.168.0.14/16 dev eno2.10
  • Next, activate the private interface and the VLAN subinterface:

    sudo ip link set dev eno2 up
    sudo ip link set dev eno2.10 up
  • To make the configuration persistent, add the following entries to the configuration file:

    sudo nano /etc/network/interfaces.d/50-cloud-init
    auto eno2.10
    iface eno2.10 inet static
       address 192.168.0.14
       netmask 255.255.0.0
       broadcast 192.168.255.255
       vlan-raw-device eno2
  • Overview:

    Bare - Configuring the vRack between the public cloud and a dedicated server

  • Restart the network to apply the changes:

    sudo systemctl restart networking

 

Go further

Creating multiple VLANs in a vRack

Browse all the Dedicated Servers guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Dedicated Servers on the OVHcloud US website.