HetznerCloud WHMCS Module Documentation

Version 1.15

Table of Contents

1. Introduction

2. Requirements

3. Installation

4. Configuration

5. Creating a Product

6. Client Area Features

7. Troubleshooting

8. License Management

9. FAQs

1. Introduction

The Hetzner Cloud WHMCS Module allows hosting providers to automate the provisioning and management of Hetzner Cloud servers directly from WHMCS.

Key Features:

✅ Automated Server Provisioning – Create, suspend, terminate, and manage Hetzner Cloud VPS.
✅ Client Control Panel – Clients can reboot, reset passwords, access web console, and manage firewalls.
✅ Reverse DNS Management – Easily update PTR records.
✅ ISO Management – Attach/detach ISOs for OS reinstallation.
✅ Firewall Rules – Create and manage inbound/outbound firewall rules.
✅ Licensing System – Protect your module with WHMCS Licensing.

2. Requirements

Before installation, ensure your system meets the following requirements:

• WHMCS 8.0+ (Tested on WHMCS 8.6+)

• PHP 7.4+ (Recommended: PHP 8.1)

• cURL (Enabled in PHP)

• Hetzner Cloud API Token (From your Hetzner Cloud account)

• Valid License Key (Purchased from CloudWave)

3. Installation

Step 1: Upload Module Files

1. Download the module files (hetznercloud.php, ApiClient.php, and clientarea.tpl).

2. Upload them to:

    

   /modules/servers/hetznercloud/

   • hetznercloud.php (Main module file)

   • lib/ApiClient.php (API client)

   • templates/clientarea.tpl (Client interface)

Step 2: Activate the Module

1. Go to WHMCS Admin → Setup → Products/Services → Servers.

2. Click Add New Server.

3. Select Hetzner Cloud from the dropdown.

4. Click Save Changes.

4. Configuration

Step 1: Configure Server Settings

1. Go to Setup → Products/Services → Servers.

2. Edit the Hetzner Cloud server settings.

3. Fill in the required fields:

4. Click Save Changes.

5. Creating a Product

Step 1: Add a New Product

1. Go to Setup → Products/Services → Products/Services.

2. Click Create a New Product.

3. Select Server (VPS/Dedicated).

Step 2: Configure Product Details

• Product Name: Hetzner Cloud VPS

• Module: Hetzner Cloud

• Server Group: Select your Hetzner Cloud server.

Step 3: Set Pricing & Custom Fields

• Configure pricing (Monthly/Annually).

• Add custom fields if needed (e.g., Location, Image).

6. Client Area Features

1. Server Information

Clients can view:
✔ Server ID, Name, IPv4/IPv6
✔ CPU, RAM, Disk, Location
✔ Root Password (hidden by default)

2. Server Controls

• Reboot / Start – Restart the server.

• Reset Root Password – Generate a new root password.

• Power Off – Shut down the server.

• Web Console – Access via noVNC.

3. Rebuild Server

Clients can reinstall the OS with different images.

4. Reverse DNS (PTR) Management

Update DNS records for IPv4/IPv6.

5. ISO Management

• Attach ISO – Boot from an ISO.

• Detach ISO – Revert to disk boot.

6. Firewall Rules

• Inbound/Outbound Rules – Manage traffic filtering.

• Delete Firewalls – Remove unwanted rules.

7. Troubleshooting

Common Issues & Solutions

8. License Management

• The module requires a valid license key.

• If the license expires, the module will stop working.

• To renew, purchase a new license from CloudWaveBD.

9. FAQs

Q: Where do I get my Hetzner Cloud API token?

A: Go to Hetzner Cloud Console → Security → API Tokens → Generate API Token.

Q: Can clients change the server type after creation?

A: No, they must rebuild the server with a new image.

Q: How do I update the module?

A: Replace the files and recheck the license.

Q: Can I use this for reseller hosting?

A: Yes, clients get full control over their VPS.

Support

For assistance, contact:
Email: support@cloudwavebd.com
Website: https://cloudwavebd.com

Conclusion

This module simplifies Hetzner Cloud server management within WHMCS, providing automation and client control. Follow this guide for smooth deployment.

Happy Hosting!