fix(docs): restore install doc corrections lost in #213 merge
#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 fromf60aca1.
This commit is contained in:
parent
aa377faf95
commit
12c3821ac3
3 changed files with 23 additions and 22 deletions
|
|
@ -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`.
|
|
||||||
|
|
|
||||||
|
|
@ -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.
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue