> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# OVH Reference

> Configuration options, regions, instance flavors, and API endpoints for Ankra-managed OVH clusters.

Reference material for [OVH clusters](/guides/ovh-clusters).

***

## Cluster Configuration Options

| Parameter                 | Default       | Description                                                                           |
| ------------------------- | ------------- | ------------------------------------------------------------------------------------- |
| `name`                    | *required*    | Unique cluster name                                                                   |
| `credential_id`           | *required*    | OVH API credential ID                                                                 |
| `ssh_key_credential_id`   | *required*    | SSH key credential ID                                                                 |
| `region`                  | *required*    | OVH Cloud region                                                                      |
| `network_vlan_id`         | `0`           | VLAN ID for the private network                                                       |
| `subnet_cidr`             | `10.0.1.0/24` | Subnet CIDR range                                                                     |
| `dhcp_start`              | `10.0.1.100`  | DHCP allocation range start                                                           |
| `dhcp_end`                | `10.0.1.200`  | DHCP allocation range end                                                             |
| `gateway_flavor_id`       | `b2-7`        | Instance flavor for the gateway                                                       |
| `control_plane_count`     | `1`           | Number of control plane nodes                                                         |
| `control_plane_flavor_id` | `b2-15`       | Instance flavor for control planes                                                    |
| `worker_count`            | `1`           | Number of worker nodes (legacy, use `node_groups` instead)                            |
| `worker_flavor_id`        | `b2-15`       | Instance flavor for workers (legacy, use `node_groups` instead)                       |
| `node_groups`             |               | Array of node group definitions (see [Node Groups](/guides/ovh-clusters#node-groups)) |
| `distribution`            | `k3s`         | Kubernetes distribution                                                               |
| `kubernetes_version`      | *latest*      | Kubernetes version (optional)                                                         |

### OVH Cloud Regions

| Region  | Location               |
| ------- | ---------------------- |
| `GRA7`  | Gravelines, France     |
| `GRA9`  | Gravelines, France     |
| `GRA11` | Gravelines, France     |
| `SBG5`  | Strasbourg, France     |
| `BHS5`  | Beauharnois, Canada    |
| `WAW1`  | Warsaw, Poland         |
| `DE1`   | Frankfurt, Germany     |
| `UK1`   | London, United Kingdom |
| `SGP1`  | Singapore              |
| `SYD1`  | Sydney, Australia      |

<Note>
  The regions enabled on each OVH project differ. A region that is not enabled on the project's private network fails the reconcile during network setup. List the regions a credential can actually deploy in with `ankra cluster ovh regions --credential-id <credential_id>` before creating a cluster.
</Note>

### OVH Instance Flavors

| Flavor  | vCPUs | RAM   | Description                                          |
| ------- | ----- | ----- | ---------------------------------------------------- |
| `b2-7`  | 2     | 7 GB  | Suitable for gateways                                |
| `b2-15` | 4     | 15 GB | General purpose, good for control planes and workers |
| `b2-30` | 8     | 30 GB | Higher performance workloads                         |
| `b2-60` | 16    | 60 GB | Memory-intensive workloads                           |

<Note>
  Available flavors vary by region. Check the [OVH Cloud catalog](https://www.ovhcloud.com/en/public-cloud/prices/) for your region's offerings.
</Note>

***

## Node Group API Reference

| Endpoint                                                     | Method | Description                |
| ------------------------------------------------------------ | ------ | -------------------------- |
| `/api/v1/clusters/ovh/{id}/node-groups`                      | GET    | List all node groups       |
| `/api/v1/clusters/ovh/{id}/node-groups`                      | POST   | Add a node group           |
| `/api/v1/clusters/ovh/{id}/node-groups/{name}/scale`         | PUT    | Scale a node group (0–100) |
| `/api/v1/clusters/ovh/{id}/node-groups/{name}/instance-type` | PUT    | Change instance flavor     |
| `/api/v1/clusters/ovh/{id}/node-groups/{name}/labels`        | PUT    | Update labels              |
| `/api/v1/clusters/ovh/{id}/node-groups/{name}/taints`        | PUT    | Update taints              |
| `/api/v1/clusters/ovh/{id}/node-groups/{name}`               | DELETE | Delete a node group        |