Self-Hosting BOA — install, keep current, recover

This guide is for you if you want to run your own BOA server and you're not (yet) a seasoned sysadmin. You own one box — a VPS or a dedicated server — and you'd like BOA to do the heavy lifting so you can host Drupal sites without becoming a full-time system administrator first.

The scope is narrow on purpose, and it covers what you actually need:

  • Install BOA cleanly onto a fresh box.
  • Keep it current — BOA updates itself, and you run the occasional upgrade by hand.
  • Recover — get back on your feet when a service won't start, you're locked out, or you've run out of disk.

That's the whole promise: BOA is built so it just works. You don't need to understand Aegir internals or hand-tune Nginx to run a solid, secure, self-updating Drupal host.

Every task on the pages below is one clear path, step by step. We tell you what you should see at each stage and roughly how long to wait, and we flag the do-not-panic moments up front — for example, the installer goes quiet for long stretches while it compiles things, and that's completely normal. We don't show you five expert ways to do a thing; we show you the one that works.

In this guide

  • Is BOA for me? — what BOA gives you, what running your own box really means, and how to decide before you commit.
  • Before you install — pick the right OS and box specs, get your SSH key in place, and learn the caveats that bite first-timers.
  • Install BOA — the full install from a bare box, copy-paste commands, and what each quiet stretch means.
  • Debian to Devuan — if your provider only offers Debian, the guided autoinit conversion that gets you onto BOA's preferred OS.
  • Essential settings — the handful of .cnf knobs a beginner should set, each with a safe default and why it matters.
  • Keeping BOA current — how SKYNET keeps BOA updating itself, and how to run an upgrade by hand when you want to.
  • Upgrading the operating system — moving your box to a newer OS release the safe, BOA-blessed way.
  • When the box breaks — the calm checklist for a service that won't start, being locked out, or a site that's down.
  • Resize the root disk — reclaiming space and growing your root filesystem after your provider gives you a bigger disk.

Work through them roughly in order the first time. Once you're up and running, you'll mostly come back to Keeping BOA current and When the box breaks.

Outgrown this guide? Performance tuning, security hardening, the monitor stack, the full control-file reference and everything else lives in Operating BOA. That guide assumes you're comfortable with Aegir and Linux internals — so it's the right next step once "install, keep current, recover" no longer covers what you want to do. We point you there at the exact moments a task goes beyond this guide.