Hetzner Cloud API - Rhai Wrapper

This project provides a Rhai wrapper for interacting with the Hetzner Cloud API, allowing you to manage your servers through simple scripts.

Setup

To use this wrapper, you need to set your Hetzner API Token as an environment variable. You can create your own API Token by following the steps from the Hetzner docs.

export HETZNER_API_TOKEN="YOUR_API_TOKEN_HERE"

Replace "YOUR_API_TOKEN_HERE" with your actual Hetzner API token.

Usage

You can execute any .rhai script by passing it as an argument to cargo run.

cargo run -- <script_name>.rhai

For example, to run the provided test.rhai script:

cargo run -- test.rhai

API Examples

Here are some examples of what you can do with the API, taken from the test.rhai script.

1. Create a Client

All API interactions start by creating a client instance.

// Create client to communicate with Hetzner API
let client = new_hetzner_client(HETZNER_API_TOKEN);

2. List Servers & Display Details

You can fetch all your servers and display their details in a formatted table.

// List all servers and print in table
print("Listing all servers...");
let servers = client.list_servers();
print(servers.show_table());

// Get a specific server by ID and show its details
let test_server = client.get_server(104301883);
print(test_server.show_details());

3. Manage Server State

Perform actions like enabling rescue mode, disabling it, or rebooting the server.

// Enable rescue mode and get the root password
print(`Enabling rescue mode on server with ID: ${test_server.id}`);
let root_password = client.enable_rescue_mode(test_server.id);
print(`Root password is: ${root_password}`);

// Disable rescue mode
print(`Disabling rescue mode on server with ID: ${test_server.id}`);
client.disable_rescue_mode(test_server.id);

// Reboot server
print(`Rebooting server with ID: ${test_server.id}`);
client.reboot(test_server.id);

4. Example Output (from test.rhai script)

Listing all servers...
+-------------+-------------------+---------+-------------+
| Server List |                   |         |             |
+=============+===================+=========+=============+
| ID          | Name              | Status  | Public IPv4 |
+-------------+-------------------+---------+-------------+
| 104298257   | ubuntu-4gb-fsn1-2 | Running | 91.99.1.255 |
+-------------+-------------------+---------+-------------+
| 104301883   | ubuntu-4gb-fsn1-4 | Running | 91.99.178.6 |
+-------------+-------------------+---------+-------------+

Listing details from server with ID 104301883...
+-------------------+----------------------+
| ubuntu-4gb-fsn1-4 |                      |
+===================+======================+
| ID                | 104301883            |
+-------------------+----------------------+
| Status            | Running              |
+-------------------+----------------------+
| Created           | 2025-07-15T12:25:29Z |
+-------------------+----------------------+
| IPv4              | 91.99.178.6          |
+-------------------+----------------------+
| Type              | cx22                 |
+-------------------+----------------------+
| Included Traffic  | 20480 GB             |
+-------------------+----------------------+
| Ingoing Traffic   | 0 MB                 |
+-------------------+----------------------+
| Outgoing Traffic  | 0 MB                 |
+-------------------+----------------------+
| Primary Disk Size | 40                   |
+-------------------+----------------------+
| Rescue Enabled    | false                |
+-------------------+----------------------+

Enabling rescue mode on server with ID: 104301883
Root password is: wNMnAWwkfJEA

Disabling rescue mode on server with ID: 104301883

Rebooting server with ID: 104301883