> Index of every page on this site: [llms.txt](https://docs.a-line.cloud/llms.txt)

# OVHcloud

> Run clusters on OVHcloud Public Cloud, in regions we run for you.

## How it works

OVH is a provider we run for you, like Hetzner. Pick `ovh` and a region when
you create a cluster: the servers, volumes, networks and load balancers live
in our OVHcloud accounts and are billed from your credit. You don't need an
OVHcloud account, a Public Cloud project or any OVH credentials, and you
can't connect your own.

## Regions

A cluster lives in one region. Clusters, IaC files and prices use the region
id, which maps to one OVH Public Cloud region:

| Region id | OVH region | Location |
| --- | --- | --- |
| `gravelines` | GRA11 | Gravelines, France |
| `strasbourg` | SBG5 | Strasbourg, France |
| `frankfurt` | DE1 | Frankfurt, Germany |
| `warsaw` | WAW1 | Warsaw, Poland |
| `london` | UK1 | London, United Kingdom |

In IaC files the OVH region code (`GRA11`) is accepted as an alias of the
region id and stored as the id (`gravelines`).

## Node families

Servers are OVH Public Cloud instances. The machine picker offers three
families, each in several sizes:

| Family | Use |
| --- | --- |
| B3 (general purpose) | Balanced CPU and memory, a good default. |
| C3 (compute optimized) | More CPU per GB of memory. |
| R3 (memory optimized) | More memory per CPU, for databases and caches. |

A node type id is the provider and the OVH flavor, for example `ovh-b3-8`.
Not every size is in stock in every region at every moment; when OVH has no
capacity, adding the server fails with a message saying so.

## Load balancers

Load balancers are OVH Public Cloud Load Balancers, in three sizes:

| Type | Targets | Listeners |
| --- | --- | --- |
| `small` | 25 | 5 |
| `medium` | 50 | 10 |
| `large` | 100 | 20 |

HTTP and HTTPS use two listeners; the rest are free for TCP ports. The public
address is a floating IP. OVH load balancer sizes cannot be changed in place,
so a resize creates a new load balancer of the new size and moves the address
over to it, then removes the old one. The address stays the same; expect a
short interruption while it moves.

## Billing

OVH servers, volumes and load balancers are billed hourly, from your
[prepaid credit](/billing#credit), like any other cloud server. There
is no monthly term or setup fee: removing a server stops its charges.

## In IaC

Set `provider: ovh` and a region id in the [cluster file](/iac/clusters):

```yaml title="clusters/ovh-gra11.yaml" iac tree=ovh
# yaml-language-server: $schema=https://a-line.cloud/schemas/iac/v1.json
version: 1
provider: ovh
region: gravelines
load_balancers:
  - name: public
    type: small
pools:
  - name: control-plane
    role: control_plane
    node_type: ovh-b3-8
    count: 3
  - name: general
    node_type: ovh-b3-16
    count: 2
```

A load balancer `type` is the size name (`small`, `medium`, `large`). An
unknown type is refused, with the available types in the message.
