BOA Documentation

Welcome. BOA documentation is split into four guides, one per kind of reader. Pick the one that matches how you use BOA — each guide is written for you and stays in your language, so you won't trip over material meant for someone else.

This is the only page that points at all four. Once you're in a guide, everything links within that guide.

Which guide is for me?

🌊 Using BOA — for site owners on a hosted account

You log in to the Aegir control panel and your limited (SFTP) shell. You manage your own sites — create them, clone them, back them up, request SSL — but you don't run the server itself. No root, no installing.

→ Using BOA

⚓ Self-Hosting BOA — for running BOA on your own server

You have root on your own box and you want BOA to install, stay up to date, and recover when something breaks — without becoming a full-time sysadmin. Step by step, with safety rails.

→ Self-Hosting BOA

🐙 Operating BOA — the advanced root reference

You run BOA in production and you know your way around Aegir and Linux. You want the complete reference: every control variable, threshold, tuning knob, the monitor stack, security internals, backups, performance.

→ Operating BOA

🔧 Developing BOA — for BOA maintainers

You hack on BOA itself — the Barracuda/Octopus scripts and the Aegir forks. APIs, the build/test pipeline, the release and SKYNET mechanics.

→ Developing BOA

Quick reference (any guide)

• Reference appendix — every control/INI variable and CLI command, in one searchable list.
• Discontinued features — what BOA used to ship and what replaced it.