# Configurable Option

### Hetzner Datacenter module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-hetzner-datacenter.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-HetznerDatacenter/) | [FAQ](https://faq.puqcloud.com/)

#### **Overview**

Configurable Options in WHMCS allow clients to choose specific configurations while ordering a product. In the **PUQ Hetzner Datacenter** module, these options are used to select an **Operating System** image and enable **Backup access**.

#### **What this does**

WHMCS *Configurable Options* let clients choose parameters during order. In this module they are used to: **(1)** pick an *Operating system* image; **(2)** enable/disable *Backup* access.

#### **Step 1 — Create a Configurable Option Group and link it to your product**

1. Go to `System Settings → Products/Services → Configurable Options` and click **Create a New Group**.
2. Set **Group Name** (e.g., “hetzner”) and **Description** (optional).
3. In **Assigned Products** select your Hetzner product (e.g., “Hetzner Datacenter – Hetzner product”).
4. Click **Save Changes**.

[![image-1761138691245.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/image-1761138691245.png)](https://doc.puq.info/uploads/images/gallery/2025-10/image-1761138691245.png)

#### **Step 2 — Add options inside the group**

##### **2.1 Operating system (Dropdown)**

1. Click **Add New Configurable Option**.
2. Set **Option Name**: *Operating system*; **Option Type**: *Dropdown*.
3. Add values (examples): *ubuntu-20.04*, *ubuntu-22.04*, *debian-11 etc*.
4. Optionally define pricing per currency and billing cycle.
5. Save.

[![image-1761138707713.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/image-1761138707713.png)](https://doc.puq.info/uploads/images/gallery/2025-10/image-1761138707713.png)

##### **2.2 Backup (Yes/No)**

1. Click **Add New Configurable Option** again.
2. Set **Option Name**: *Backup*; **Option Type**: *Yes/No*.
3. Optionally add a price for enabling backup (per currency/cycle).
4. Save.

[![image-1761138729321.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/image-1761138729321.png)](https://doc.puq.info/uploads/images/gallery/2025-10/image-1761138729321.png)

#### **Step 3 — Map these options in the module settings**

Open your product → **Module Settings** (PUQ Hetzner Datacenter) and map the WHMCS options to the module controls:

- **Custom option name for image** — choose *Operating system*. This lets clients select the OS during order.   
    [![image-1761138748588.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/image-1761138748588.png)](https://doc.puq.info/uploads/images/gallery/2025-10/image-1761138748588.png)
- **Backup** — tick *Allow access to server backup* and select the *Backup* option from the dropdown.   
    [![image-1761138765646.png](https://doc.puq.info/uploads/images/gallery/2025-10/scaled-1680-/image-1761138765646.png)](https://doc.puq.info/uploads/images/gallery/2025-10/image-1761138765646.png)

#### **Available Operating Systems and Application Images**

All available operating system and application images can be viewed in the dropdown list when selecting an ISO image in the product configuration.  
This list is always dynamically updated from the Hetzner API, so it reflects the most recent system templates.  
The module uses the **Name** field value (for example: `debian-11`).

Examples of available system images that can be added to the **Operating system** configurable option:

- debian-11
- debian-12
- debian-13
- ubuntu-20.04
- ubuntu-22.04
- ubuntu-24.04
- centos-stream-9
- centos-stream-10
- rocky-8
- rocky-9
- rocky-10
- alma-8
- alma-9
- alma-10
- fedora-41
- fedora-42
- opensuse-15

In addition to standard operating systems, the Hetzner catalog also includes preconfigured application images.  
These can also be added to the same configurable option group if you want to allow clients to deploy ready-to-use environments:

- lamp
- wordpress
- jitsi
- nextcloud
- docker-ce
- gitlab
- prometheus-grafana
- wireguard
- owncast
- photoprism
- rustdesk
- coolify

All these image names can be used directly in the **Operating system** dropdown when creating configurable options in WHMCS.

#### **How it behaves for the client**

- At order time, the client chooses an OS from *Operating system* and toggles *Backup* (Yes/No).
- The module deploys the server with the selected image. If *Backup* is enabled, backup management becomes available in the client area.

#### **Naming rules (important)**

- Option names in WHMCS must match those selected in the module: exactly *Operating system* and *Backup*.
- If you rename an option later, revisit the Module Settings and re-select it in the dropdowns.