How to create and manage routes

Routes allow you to specify, for a given frontend, which backends it should direct traffic to depending on the requested host. For HTTP frontends/backends, routes are based on HTTP Host headers. For TCP frontends/backends, they are based on Server Name Identification (SNI). You can configure multiple routes on a single frontend. When no route rules match for an incoming connection/request, the frontend will forward to its default backend.

Before you start

To complete the actions presented below, you must have:

• A Scaleway account logged into the console
• Owner status or IAM permissions allowing you to perform actions in the intended Organization
• Created a Load Balancer

How to create routes

1. Click Load Balancers in the Network section of the Scaleway console side menu.

2. Click the Load Balancer you want to create a route for.

3. Click the Frontends tab.

4. Click the frontend you want to create a route on.

5. Click the Routes tab.

6. Click «Plus Icon» Create route to create a new route.

7. Enter the following information to configure the route:

   • Source frontend: The current frontend is pre-set.
   • Target backend: Select the backend to which the frontend should direct traffic to for this rule.

   If you have selected an HTTP frontend/backend pair:

   • HTTP Host header: Enter an HTTP Host header value to filter for (for example www.example-domain.com). Traffic with a matching value in its HTTP Host header will be directed to the specified target backend.

   If you have selected a TCP frontend/backend pair:

   • SNI value: Enter an SNI value to filter for (for example www.example-domain.com). Traffic with a matching SNI value will be directed to the specified target backend.

8. Click Create route to finish.

Your route is created, and you are taken to the list of all your routes for this Load Balancer.

You can repeat this process to create as many routes as you want.

How to edit routes

1. Click Load Balancers in the Network section of the Scaleway console side menu.

2. Click the Load Balancer you want to edit routes for.

3. Click the Frontends tab.

4. Click the frontend you want to edit a route on.

5. Click the Routes tab.

6. Click the «See more Icon» icon next to the route you want to edit, and select Edit from the drop-down list.

7. Edit the backend and/or SNI/HTTP Host header value as required.

8. Click Edit route to finish.

Your route is edited, and you are returned to the list of routes.

How to delete routes

1. Click Load Balancers in the Network section of the Scaleway console side menu.

2. Click the Load Balancer you want to delete routes for.

3. Click the Frontends tab.

4. Click the frontend you want to delete routes on.

5. Click the Routes tab.

6. Click the «See more Icon» icon next to the route you want to delete, and select Delete.

7. Confirm the action by clicking Delete route.