fix(docs): restore install doc corrections lost in #213 merge
Some checks are pending
CI / rust (pull_request) Waiting to run
CI / markdown (pull_request) Waiting to run
CI / port (pull_request) Waiting to run
CI / agent-jail-pkgs (pull_request) Waiting to run

#219 replaced just install with clawdie binary commands but #213
merge (0aeebee) overwrote controlplane-install.md, index.md, and
requirements.md — restoring the corrected versions from f60aca1.
This commit is contained in:
Sam & Claude 2026-06-26 15:26:04 +02:00
parent aa377faf95
commit 12c3821ac3
3 changed files with 23 additions and 22 deletions

View file

@ -1,24 +1,23 @@
--- ---
title: 'Control Plane Install' title: 'Control Plane Install'
description: Install the Clawdie control plane with the standard orchestrator. description: Install the Clawdie control-plane host service with the clawdie binary.
--- ---
The control plane is installed by the standard orchestrator: The control plane runs as the host-managed `clawdie` service (`colibri-daemon`),
provisioned by the `clawdie` binary:
```bash ```bash
just install cargo build -p clawdie --release
clawdie apply --yes
``` ```
The root install runs the control plane as the host-managed Clawdie service. This installs the storage datasets, the `clawdie` service user, and the rc.d
The orchestrator configures PF, worker jails, PostgreSQL, hostd, service (FreeBSD) / systemd (Linux) unit that runs `colibri-daemon`. Preview first with
installation, checkpoints, and resume state together. `clawdie plan`; `apply` is a dry-run until you pass `--yes`. See
[Install](./install/) for the full command set, storage strategy, and safety
notes.
If an install fails, resume from the failed step: > **Scope.** This provisions the control-plane host service only. PF egress,
> worker jails, PostgreSQL, and the CMS/web service were handled by the legacy
```bash > clawdie-ai `just` + Ansible orchestrator and are not yet part of the colibri
just install-from-db > installer. The canonical Bastille/Warden bridge name remains `warden0`.
just install-from hosts
just install -- --dry-run
```
The canonical Bastille/Warden bridge name is `warden0`.

View file

@ -21,5 +21,5 @@ Use this path for a new machine or a reinstall from boot media.
Use this path when FreeBSD 15.x is already installed and you manage the host. Use this path when FreeBSD 15.x is already installed and you manage the host.
- [Requirements](./requirements/) — host, runtime, and toolchain requirements. - [Requirements](./requirements/) — host, runtime, and toolchain requirements.
- [Install orchestrator](./install/) — run `just install` and resume failed steps. - [Install](./install/) — provision the host service with the `clawdie` binary (`clawdie discover` / `plan` / `apply --yes`).
- [Fresh install checklist](./fresh-install-checklist/) — verify the completed install. - [Fresh install checklist](./fresh-install-checklist/) — verify the completed install.

View file

@ -5,7 +5,7 @@ description: Host, runtime, and toolchain requirements for Clawdie.
What you need on the host before installing Clawdie. The ISO installer What you need on the host before installing Clawdie. The ISO installer
provisions most of this automatically; existing-host installs should verify provisions most of this automatically; existing-host installs should verify
these requirements before running `just install`. these requirements before running `clawdie apply`.
## Host ## Host
@ -18,13 +18,15 @@ these requirements before running `just install`.
## Toolchain ## Toolchain
- **Rust** via rustup, installed under `/opt/clawdie/rustup`. - **Rust** (Cargo) — the colibri control plane and the `clawdie`
Required for native dependencies (SWC, tree-sitter). The ISO installer are a Cargo workspace. Build the installer with
installs this; existing-host installs run it from `cargo build -p clawdie --release`. See [Install](./install/).
[`Install orchestrator`](./install).
- **Node.js + tsx** for the install scripts and runtime.
- **Bastille** for jail management. - **Bastille** for jail management.
> The legacy clawdie-ai `just` + Node/`tsx` orchestrator is not used in this
> repo; the sections below still describe the clawdie-ai product runtime and are
> being reconciled to the colibri model.
## Runtime philosophy ## Runtime philosophy
Clawdie is a single Node.js process that orchestrates jailed Clawdie is a single Node.js process that orchestrates jailed