---
title: "Connect Hetzner and launch machines for accounts"
locale: en
url: https://tlg.builera.app/en/docs/guides/nodes-hetzner
verified: 2026-10-24
app_version: "2.0"
---

# Connect Hetzner and launch machines for accounts

Connect your Hetzner project so the app can create and manage machines for Telegram accounts.


Connect your Hetzner project so the app can launch machines and install the worker automatically. Hetzner bills you directly for infrastructure.

## Who can do this

Only the workspace Owner can connect or remove a Hetzner token. Once connected, Owners or Managers can launch and manage machines.

## Before you start

A Hetzner Cloud account with verified billing. Create a separate project for Telegram-Auto so the token has no access to other infrastructure.

> [!IMPORTANT]
> A Read & Write token can manage resources in the project. Do not use a project containing machines for other services. Do not send the token in support messages. Completely cover tokens in images.

## Where to start

Open **Machines**, then select **Connect Hetzner**.

## Steps

1. Open Hetzner Console.
2. Create a separate project for Telegram-Auto.
3. In the project, open **Security → API tokens**.
4. Create a token with **Read & Write** permissions.
5. Copy the token into **Paste Read & Write token** in the app.
6. Enter a **Project name (for your reference)**.

   ![Hetzner project connection dialog with the token completely covered](https://tlg.builera.app/docs-media/en/hetzner-connect.webp "Use a token from a separate project")

7. Click **Check & connect**.
8. Once connected successfully, click **Add machine**.
9. Select a suitable **Region**.
10. Check the specifications, price, and expected capacity.

The app fetches prices from Hetzner and chooses the cheapest machine type in the selected region among those meeting the minimum memory requirement. This is not a promise to choose the cheapest machine across all regions.

The displayed price includes the machine and IPv4, excluding VAT. Do not treat a fixed introductory figure as a quote. The default Hetzner machine capacity is **40 accounts**, according to `DEFAULT_CAPACITY_HETZNER`. Check the actual capacity and usage on screen.

> [!WARNING]
> Launching a machine creates billable resources in your Hetzner account.

11. Click **Launch machine**.
12. Open the machine details to follow **Installation logs**.
13. Wait for **Worker connected** before assigning accounts.

### Delete a machine

> [!WARNING]
> Deleting a Hetzner machine deletes the machine, IPv4, and its dedicated firewall. Do not use this as a way to pause jobs.

1. Move accounts off the machine if it still has any.
2. Open the details of the machine you want to delete.
3. Click **Delete machine**.
4. Enter the machine name in **Retype the machine name to confirm**.
5. Confirm **Delete machine**.

### Support SSH access

Machines may display **Support team has SSH access** while a temporary support session is active.

The workspace interface currently has no step for you to grant SSH access. The tools for opening and closing sessions are in platform administration, not in the workspace's machine details.

## Result

The new machine appears in the workspace with the worker installed. It can accept accounts once connected, provided it has space and has not stopped accepting new accounts.

## Check

Verify the region, price, connection status, and number of assigned accounts. In the machine details, check installation logs and resource metrics when data is available.

## If something goes wrong

If machine creation fails, read the logs before using **Retry machine creation**. If the token has been removed, the machine may keep running, but the app can no longer manage Hetzner. The Owner needs to reconnect it.

See [machine offline](https://tlg.builera.app/en/docs/troubleshooting/machine-offline).

## Do it with the API or MCP

Connecting and removing Hetzner tokens are actions for people using the app only. There is no public action page for them.

Once connected, use [hetzner.offers](https://tlg.builera.app/en/docs/reference/rest/hetzner.offers), [nodes.create_hetzner](https://tlg.builera.app/en/docs/reference/rest/nodes.create_hetzner), and [nodes.delete](https://tlg.builera.app/en/docs/reference/rest/nodes.delete). MCP names: `hetzner_offers`, `nodes_create_hetzner`, `nodes_delete`.