Skip to content

Set Up Your System

The soil. Bitcoin Core, your Lightning node, the mint, and Orchard all run on this one machine, so it is the first thing to get right. Liveness is critical to both the lightning node and the mint. This makes the host itself critical to your service model.

Run it on a machine you control with reliable hardware — a home server or a hosted VPS. Both work, and the rest of this guide is the same either way; the section below lays out the trade-off.

  • A host you control with room for the whole stack: a 2 TB+ SSD for a full Bitcoin node and the data that grows with it, 4 GB+ RAM, and a connection that stays online.
  • A supported Linux OS. The stack targets Ubuntu Server LTS. Install it and keep it patched.
  • Hardened remote access: key-only SSH, a non-root admin user with sudo, and the SSH port reachable only to you.
  • Security and privacy hardening: a default-deny firewall that opens only the ports each service needs, plus the network and privacy measures that keep the host locked down.
  • A backup plan for keys and configuration, in place before anything holds value.

Both work, and the rest of this guide is the same either way. The choice comes down to one trade-off: a home server maximizes sovereignty and privacy, while a VPS maximizes uptime and reachability. For a mint — public-facing infrastructure that holds value — we lean toward the home server, but a VPS is a reasonable lighter-touch start.

Home serverHosted VPS
ControlHardware is physically yoursThe provider owns the host
Key & data privacyKeys never leave your hardwareThe provider can access disk and RAM
UptimeRests on your power and home internetDatacenter-grade, often with an SLA
Public reachabilityMore manual configuration and networkingStatic public IP off the shelf
BandwidthCapped by residential uploadHigh and symmetric
CostOne-time hardwareRecurring monthly fee
SetupYou install the OS yourself (step 1.2)Arrives with Linux and SSH ready
Best whenSovereignty and privacy come firstYou want reliable uptime without running hardware

We do not reproduce these steps. MiniBolt’s System section is the guide we recommend (see the guides we build on for why). Open it and work through 1.1–1.6 — it applies almost as written. The tips below cover the only differences: one for everyone, plus a few if you’re on a VPS.

Follow MiniBolt’s steps as written. The one addition: in 1.1 Preparations, when you write down your passwords, add an Orchard setup key to the list.

A VPS arrives as a running Linux box with SSH already enabled, so a few steps shift:

  • Skip 1.2 Operating system. Your provider already installed Linux.
  • 1.3 Remote access: ssh at the public IP your provider gives you as there is no machine to find on your local network.
  • 1.4 Configuration: its first task, “Add the admin user,” creates the admin account the rest of the guide runs as — MiniBolt builds it from the throwaway temp user made during the OS install. You skipped that install, so run those same steps from the root or ubuntu login your provider gave you. That login stands in for temp: retire it once admin works (delete the spare ubuntu user, or disable root SSH).

New Mint System

Last updated: