sailfork / t3code-github / .repos/ alchemy-effect/ website/ src/ content/ docs/ hetzner/ index.mdx

An Alchemy app on Hetzner is one or more Servers — real VMs, booted in seconds and billed by the hour — running your Effect programs as Services: bundled with rolldown, copied over SSH, and supervised by systemd. No Dockerfile, no ansible, no hand-written unit files. Around them you declare the rest of the platform — volumes, private networks, firewalls, load balancers, and DNS — in the same TypeScript program.

New here? Set up your project and API token, then start the tutorial.

Compute

  • Servers — the VM: pick a serverType, an image, and a location; attach SSH keys, networks, firewalls, volumes, and placement groups. Alchemy injects a deploy key so it can reach every server it manages.
  • Services — your code on a Server. An HTTP fetch handler (or a background process) deployed as a systemd unit; N Services can share one Server.
  • SSH — typed exec/scp against any managed Server, usable from deploy-time Effects.
  • Images & snapshots — snapshot a Server with Hetzner.Image, look up stock images with Hetzner.findImage.

Frontend

Storage

  • Volumes — network block storage attached to a Server. Mount one into a Service with the MountVolume binding and read/write it like a local directory.

Networking

  • Networks, Firewalls & Load Balancers — private networks with subnets, stateful firewall rules applied to servers, and managed load balancers with health checks and TLS certificates.
  • Floating & Primary IPs — stable public addresses that survive server replacement.

DNS

  • Zones & records — Hetzner DNS zones and record sets as resources, plus ReadDns/WriteDns bindings for querying and mutating records from deploy-time Effects.

What are you building?

You're buildingReach for
An HTTP API on a VMServer + Service
A Vite SPAWebsite.Vite — pass server to share the VM
An SSR site (Astro, Next, Nuxt, …)Website
A background worker / daemonService with host.run(...) — no port, no HTTP
Persistent state on diskVolume + MountVolume
A load-balanced, TLS-terminated appLoad Balancer + Certificate
Servers talking privatelyNetwork + usePrivateIp targets
Locking down public accessFirewall
Your own domainZone + RecordSet
A stable IP across replacementsPrimary IP / Floating IP — see Networking
Golden imagesHetzner.Image snapshots — see Servers

Where next

  • Setup — create a Hetzner project, generate an API token, and connect alchemy.
  • Tutorial — from empty directory to a Server running an HTTP Service with a mounted Volume and a firewall.
  • Websites — Vite, Astro, Next.js, and other framework sites as a systemd unit.
  • Providers reference — generated API docs for every Hetzner resource Alchemy ships.