Skip to content
zefıly

Connect a Hetzner Cloud server to Zefily

Zefily can create Hetzner Cloud servers for you, install the agent on first boot, or import a server that already runs at Hetzner. This guide covers the token, the panel steps and what to check once the server is online.

Before you start

  • A Hetzner Cloud project where you can manage security settings.
  • A Zefily account that can manage servers and integrations in the organization.
  • Your SSH public key on your computer, for example from ssh-keygen -t ed25519.

Steps

  1. 1. Create the API token at Hetzner

    Open your project in the Hetzner Console, click Security in the left menu and API tokens in the top menu. Click Generate API token, enter a description and choose Read & Write. Read only allows GET requests; Zefily needs Read & Write to create, power-cycle, snapshot and delete servers.

  2. 2. Copy the token before you close the window

    Hetzner shows the token once. Save it in your password manager at once. If it is lost, generate a new token and delete the old one in the same list.

  3. 3. Add the token to Zefily

    In Zefily open Settings, then Cloud providers. Choose Hetzner Cloud, give the account a name and paste the token. Zefily verifies the token when you connect it.

  4. 4. Put your SSH key in the vault

    Open Settings, then SSH keys, and add the public key you will sign in with. The create form offers only keys from this vault, and the keys you choose are installed for root on the new server.

  5. 5. Create the server or import one

    For a new server choose Servers, then Add server, pick the Hetzner account, then its region, size and system. Tick your key and click Create server. Each region lists only the sizes that can be delivered there now. To use a server that already runs at Hetzner, choose Import an existing one instead and pick it from the list.

  6. 6. Wait for the server to come online

    The agent installs itself on the first boot, and the server shows Online in about two minutes. Pre-flight checks then run, and any blocker or warning appears on the server overview.

  7. 7. Install the web stack you need

    Pick a web stack when you add the server, or install it later from the server page: nginx or OpenLiteSpeed with PHP, or a starter stack with its database and object cache. Each part can be changed later.

Verify it works

The server page shows Online and the pre-flight checks list no blockers. Sign in from your computer with ssh root@your-server-address using the key you chose. The Hetzner console lists the server under the name you gave it.

Troubleshooting

The token is rejected
Check that the whole token was copied and that it belongs to the project you want. A Read-only token can list servers but cannot create them, so generate a Read & Write token.
A region or size is missing
The list refreshes from Hetzner stock every ten minutes. A size sold out everywhere is not shown, so choose another region or size.
The server never shows Online
Open the server page for the enrollment status. The server needs outbound HTTPS to Zefily, at least 512 MB of memory and 2 GB of free disk; the pre-flight check blocks it below these limits.

Questions

Who pays for the Hetzner server?

Hetzner bills the server to your Hetzner account as usual. Your Zefily plan is billed separately; the pricing page lists the plans.

Can I use a Hetzner server I already run?

Yes. Choose Servers, then Add server, then Import an existing one, and pick the server. Snapshots and power-cycling then work from Zefily too.

Is the Hetzner token stored in plain text?

No. Every token is encrypted with your organization key, and it is never shown again after you save it.

Read next

Start on a server you own

Create your account, connect a server and follow the guide. The server stays yours: you pay your provider.

Start free

Black Friday & Cyber Monday

Before you go: lifetime plans are on sale

Pay once for a lifetime plan, or get 30% off the first year of any yearly plan.

Only 100 lifetime plans per plan. When they are gone, they are gone.

See the campaign

Amazing November

See the campaign →