Skip to content

ADR 0004

github-actions[bot] edited this page Nov 21, 2026 · 1 revision

Status: accepted · Built: skeleton · Date: 2026-11-07 · Superseded by: 0026

Generic VPS bootstrap, optional Hetzner module

Context

Others should be able to use Spotcraft on any provider; the first deployment is on Hetzner.

Decision

The baseline is any Debian/Ubuntu VPS reachable over SSH: cloud-init.yaml installs Docker and a firewall, and compose.yaml runs the services. An optional OpenTofu module in infra/hetzner creates both servers and the private network between them.

The owner's own deployment keeps its values (Hetzner token, SSH key, domains) in a GitHub environment, never in the repository.

Consequences

  • Non-Hetzner users create the servers and the private link (e.g. WireGuard) themselves.
  • The Hetzner module needs a state backend before it is used for real.

Clone this wiki locally