0028 (ADR-006): Installation modes at first boot #33

New issue

Open

opened 2026-09-30 10:10:48 -03:00 by marcos-mendez · 0 comments

marcos-mendez commented

2026-09-30 10:10:48 -03:00

(Migrated from github.com)

Decision (maintainer, 2026-09-30). The installer uses two terms only, simple installation and advanced installation, with three modes: (1) simple: everything in one LXC, no mesh, no etcd; (2) advanced, cloud simple: database primary and replica, application files in a single LXC; (3) advanced, cloud advanced: three LXC minimum, etcd quorum, directory replication. Cloud advanced assumes three distinct sites or two plus an external arbiter, and warns in one line when all three share a host. In cloud mode the primary generates the key, password and WireGuard endpoint the replica uses.

Handbook: docs/decisions/0028-installation-modes.md (handbook#26)

Amends: 0013 (Standalone/Cloud console flow folded into these modes), 0020 (three voters still required for automatic failover; cloud simple fails over by hand; the arbiter is 0020's data-less voter).

First tasks

First-boot mode screen with the two terms and three modes; the one-line same-host warning.
Cloud simple on the existing MariaDB pair work (keel 0.11.x), Template B.

**Decision (maintainer, 2026-09-30).** The installer uses two terms only, simple installation and advanced installation, with three modes: (1) simple: everything in one LXC, no mesh, no etcd; (2) advanced, cloud simple: database primary and replica, application files in a single LXC; (3) advanced, cloud advanced: three LXC minimum, etcd quorum, directory replication. Cloud advanced assumes three distinct sites or two plus an external arbiter, and warns in one line when all three share a host. In cloud mode the primary generates the key, password and WireGuard endpoint the replica uses. **Handbook:** `docs/decisions/0028-installation-modes.md` (handbook#26) **Amends:** 0013 (Standalone/Cloud console flow folded into these modes), 0020 (three voters still required for automatic failover; cloud simple fails over by hand; the arbiter is 0020's data-less voter). **First tasks** - [ ] First-boot mode screen with the two terms and three modes; the one-line same-host warning. - [ ] Cloud simple on the existing MariaDB pair work (keel 0.11.x), Template B.