My customer accountContact commercialWebmailOVHcloud Blog

Welcome to OVHcloud.

Log in to order, manage your products and services, and track your orders

Log in

Routing a failover IP

Find out how to route a failover IP and link it to the OVH Load Balancer

Last updated 06th April 2018


A failover IP (FOIP) is an IP address that can be switched from one service to another. In doing so, it helps you avoid a wide range of issues for your infrastructure (hardware failures, overload for your services, maintenance, etc.).

For more information on failover IPs, you can consult our webpage.

The OVH Load Balancer solution offers load balancing features for a range of different protocols: HTTP, HTTPS, TCP and UDP. When you link it to a failover IP, you can switch over your existing infrastructure to a Load Balancer without disturbing or interrupting services for your customers. Effectively, you will not need to change the IP address any longer if you are still using the failover IP, so you will not need to wait for your DNS zone to propagate any changes.

For more information on the OVH Load Balancer solution, you can read our Introduction to the OVH Load Balancer.

This guide will explain how to use the failover IP with the OVH Load Balancer service.


The required Load Balancer configuration.

Once you have confirmed the changes in the list of failover IPs associated with the Load Balancer, you need to be able to refresh them. Several conditions need to be met for this to work.

  • If the Load Balancer is in a vRack, all of the farms must also be in the vRack. The Load Balancer must also have its vLAN. Otherwise, there should not be any farms in a vRack.

  • At least one existing front-end. All of the front-ends must be valid. They can be enabled and disabled, with either:

  • a valid route (with routing rules)
  • a redirection (redirectLocation)
  • a default farm

  • Nothing else should be refreshed for the Load Balancer. A Load Balancer cannot be refreshed several times at once. Doing so would not make any changes to the resulting configuration.


In this document, we will look at two distinct uses:

  • linking a failover IP to the OVH Load Balancer service
  • linking a failover IP to a single front-end of the OVH Load Balancer service

Add a failover IP.

You can link these IPs to your OVH Load Balancer via the OVH API. The API call for this is as follows:

You can then list the failover IPs linked to your OVH Load Balancer with the following API call:

The failover IPs linked to your Load Balancer will be available for all of your front-ends. This is contrary to the following case, in which we will link a failover IP to a single front-end.

Dedicated failover IP.

No matter what kind of front-end you wish to use, you can define a list of dedicated failover IPs that will be linked to them. Please note that in this particular case, your FOIP will be attached to only one single front-end. As a result, it will only give access to the service provided by this front-end. The services for your other front-ends will be accessible via your IP Load Balancer’s IP address.

Via the API.

If you are creating a front-end:

From the OVH API, you can use the following call to define one or more failover IPs on a front-end as you create it:

  • HTTP protocol
  • TCP protocol
  • UDP protocol

If you are updating an existing front-end:

From the OVH API, you can use the following call to define one or more failover IPs on an existing front-end:

  • HTTP protocol
  • TCP protocol
  • UDP protocol

Via the OVH Control Panel.

You can define dedicated FOIPs via the OVH Control Panel by going to the Cloud section, then Load Balancer.

Once you have selected the Load Balancer you want to modify, create a new front-end, or edit an existing one.

In Advanced settings, you can select the failover IPs you would like to add to your front-end.

Configure the front-end by associating a failover IP

Once the front-end has been configured, click Add or Edit, depending on whether you are configuring a new or existing front-end.

Please remember to deploy the configuration. There are two ways of doing this:

  • via the Status section of the OVH Control Panel, by clicking on your Load Balancer’s ... button, then selecting Apply configuration

  • via the reminder box in the OVH Control Panel, notifying you that the configuration has not been applied, by clicking Apply configuration

Apply a Load Balancer configuration

Go further

Join our community of users on

Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.

These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community