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. 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. 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. 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. 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. 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. 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. 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.