Deploy Hatamoto on Hetzner Cloud
By the end you have Hatamoto running on a Hetzner Cloud server with PostgreSQL and HTTPS in place, and a link in the console that creates your owner account. You paste one cloud config into the create form and Hetzner runs it on first boot. Give the install a few minutes after you create the server.
A CPX02 in Helsinki is EUR 5.49 a month (USD 6.59) with its IPv4 address, excluding VAT.
What it costs
The CPX02 in Hetzner's Regular Performance line (shared AMD vCPUs) is the smallest plan with the 1 GB of RAM Hatamoto needs. The CX and CAX plans are marked as not available, so use CPX. Prices include the IPv4 address.
| Item | Price |
|---|---|
| CPX02, Helsinki: 1 vCPU, 1 GB RAM, 20 GB NVMe, 20 TB traffic | EUR 5.49 a month (USD 6.59) |
| CPX02, Falkenstein or Nuremberg | EUR 6.49 a month (USD 8.09) |
| CPX22, Helsinki: 2 vCPUs, 4 GB RAM, 80 GB NVMe, 20 TB traffic | EUR 16.99 a month (USD 20.09) |
| IPv4 address, if priced alone | EUR 0.50 a month (USD 0.60) |
| Snapshots | EUR 0.0143 per GB a month |
Prices as of 13 November 2026, from Hetzner's Regular Performance plan page and its price file. They exclude VAT. They change, so check the provider before you order.
Before you start
- A Hetzner account and a project. The console is at console.hetzner.com.
- An SSH public key. Add it when you create the server, because the console cannot add one afterwards.
- A domain whose DNS records you control, if you want a name of your own. Skip it and Hatamoto serves a free sslip.io name, which is fine for a trial.
- An email address to give the certificate authority for expiry warnings.
Step 1: Open Add server
Sign in at console.hetzner.com and open a project, or create one. In the left menu choose Servers, then Add server.
Step 2: Choose the location, type and image
Under Location, pick Helsinki, Falkenstein or Nuremberg in Europe, Ashburn or Hillsboro in the US, or Singapore. Under Type, choose Regular Performance and the CPX02. It is listed for Europe and Singapore, and the US list starts at the CPX11. Hetzner warns that cloud instances can occasionally be unavailable to order, so pick another location if one is full. Under Image, stay on OS Images and pick Ubuntu 24.04. Cloud config needs these images, so avoid Snapshots and Apps here.
Step 3: Choose the networking and your SSH key
Under Networking, keep a public IPv4 address. Hatamoto builds its setup link from it, and Hetzner creates a Primary IP for you if you do not pick one. A public IPv6 address is free. Under SSH key, pick your key or add one. With a key, Hetzner sends no root password. Without one, it emails you a root password.
Step 4: Leave Volumes, Firewalls and Backups for now
Leave Volumes, Placement Groups and Labels alone. Firewalls is optional here, because step 8 adds one. Backups costs extra and keeps 7 daily copies at a time you cannot choose. You can enable it later.
Step 5: Paste the script into Cloud config
Scroll to Cloud config. Hetzner describes it as scripts for early initialisation of the server, up to 32 KiB. Paste this file into it:
#cloud-config
runcmd:
- sh -c 'curl -fsSL -o /tmp/hatamoto-install.sh https://hatamoto.dev/install.sh && chmod +x /tmp/hatamoto-install.sh && env HATAMOTO_DOMAIN=cms.example.com HATAMOTO_ADMIN_EMAIL=you@example.com /tmp/hatamoto-install.sh'Replace cms.example.com with your domain and you@example.com with the address for certificate expiry notices. For the sslip.io name alone, remove the env section so the command ends at /tmp/hatamoto-install.sh. Root runs the file, so there is no sudo. Leave HATAMOTO_SETUP_CODE out and Hatamoto makes a random one and shows it in the console.
Step 6: Name the server and create it
Type a Name. It must be a valid hostname and unique in the project. Click CREATE & BUY NOW. The server starts and its IPv4 address appears in the list.
Step 7: Point your domain at the server
Copy the server's IPv4 address. At your DNS host, create an A record for your domain that points at it. If the record is not live when the install ends, Hatamoto starts on the sslip.io name and switches to your domain within minutes of the record working.
Step 8: Create a firewall for 22, 80 and 443 (optional)
Hetzner attaches no firewall unless you choose one, and Hatamoto's installer already turns on the server's own firewall for these ports, so this adds a second layer. In the left menu choose Firewalls, then Create Firewall. Under Inbound rules, add TCP rules for ports 22, 80 and 443 from any source. Under Apply to, choose your server, then CREATE FIREWALL. Once a firewall is applied, Hetzner drops all new inbound traffic that no rule allows, so keep all three.
Step 9: Connect and watch the install
The login user is root. With an SSH key, run ssh root@ followed by the server's address. For the browser console, open the server and click the console icon at the top right. It asks for the root password. If you have none, open RESCUE, then ROOT PASSWORD, then RESET ROOT PASSWORD. The console defaults to a QWERTY (en-US) keyboard. Follow the install with:
cat /var/log/cloud-init-output.logAt the end, the login message carries the "Hatamoto is ready." block.
Step 10: Create the owner account and take a snapshot
Follow the link from that block. The code is prefilled, and what follows the # stays in your browser. Once the owner account exists, read First run.
For a whole-server copy, choose Snapshots in the upper menu, then Take Snapshot, pick your server, add a description and choose Create & Buy now.
Check it worked
On the server, run:
curl -i http://127.0.0.1:8090/healthThe reply starts HTTP/1.1 200 OK. Then load your domain in a browser. The padlock and the starter home page show the install finished.
If something goes wrong
- If nothing installs, check the image. cloud-init needs Hetzner's own system images, so create the server again from an Ubuntu image on the OS Images tab.
- If SSH refuses you, use your key. With a key no root password is emailed, and the console cannot add a key after creation, so create the server again if it was missing.
- If the site stops answering after you apply a firewall, add TCP rules for 22, 80 and 443 from any source and check it is applied to the right server.
- If the location says the type is unavailable, try another location. The CPX02 is listed for Europe and Singapore only.
- If mail from the site never leaves, use port 587. Hetzner blocks ports 25 and 465 on all cloud servers by default.
Use the command line instead
Hetzner's hcloud tool has a --user-data-from-file flag. Save the script as hatamoto.yaml. This creates the key, a firewall with the three rules and the server:
hcloud ssh-key create --name my-key --public-key-from-file ~/.ssh/id_ed25519.pub
hcloud firewall create --name web
hcloud firewall add-rule web --direction in --protocol tcp --port 22 --source-ips 0.0.0.0/0 --source-ips ::/0
hcloud firewall add-rule web --direction in --protocol tcp --port 80 --source-ips 0.0.0.0/0 --source-ips ::/0
hcloud firewall add-rule web --direction in --protocol tcp --port 443 --source-ips 0.0.0.0/0 --source-ips ::/0
hcloud server create --name hatamoto --type cpx02 --image ubuntu-24.04 --location hel1 --ssh-key my-key --firewall web --user-data-from-file hatamoto.yamlEvery flag comes from the hcloud manual pages, and the commands have not been run for this page. Confirm that cpx02 can be ordered in the location you pick.
FAQ
How much does Hatamoto cost to run on Hetzner?
A CPX02 in Helsinki is EUR 5.49 a month (USD 6.59) including its IPv4 address, excluding VAT. Hatamoto is free to install.
Why not the cheaper CX or CAX plans?
Hetzner marks the CX and CAX cards as not available at the time of writing. CAX is also the only arm64 line, so this guide covers amd64 on CPX.
Can I use Debian?
Hatamoto supports Debian 12 and 13. This page covers Ubuntu 24.04, because the Debian images on Hetzner were not confirmed when it was written.
Do I need the Cloud Firewall?
No. Hatamoto's installer turns on the server's own firewall for 22, 80 and 443. A cloud firewall adds a second layer and costs nothing.
Which location should I choose?
The one nearest your visitors. The European locations include 20 TB of traffic on the CPX02, and Singapore includes 0.5 TB. Helsinki is cheaper than Falkenstein and Nuremberg.
What does it cost if I delete the server early?
You pay the hourly rate for the hours it ran, never more than the monthly cap. A powered-off server is billed until you delete it.
How do I keep the address across a rebuild?
A Primary IP can exist without a server. Create one first and choose it under Networking so the address outlives the server.
Hatamoto installs the same way on DigitalOcean, Vultr, Amazon Lightsail, Amazon EC2 and Linode. The full option list is in Install on a VPS.