clawdie/colibri
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 30
colibri/docs/guide/install/iso.md
Sam & Claude 95c487546d
Some checks failed
CI / rust (pull_request) Has been cancelled
Details
CI / markdown (pull_request) Has been cancelled
Details
CI / port (pull_request) Has been cancelled
Details
CI / agent-jail-pkgs (pull_request) Has been cancelled
Details
docs(guide): port 39 procedural docs from clawdie-ai to colibri 
New docs/guide/ tree — canonical home for operator-facing procedural docs.
Starlight frontmatter added to all files. 0.12 alignment fixes applied:

- v0.11.0 → v0.12.0 throughout
- PI_TUI_PROVIDER/MODEL → DEEPSEEK_API_KEY
- Headless Codex login → Agent runtime setup (zot + RPC mode)
- /login and auth.json references removed
- pi → zot in provider-fallback spawn reference
- colibri-provider-verify (was pi-provider-smoke)
- Language cleanup: smoke test → verification, fake → test,
  can't self-fix → requires operator intervention,
  broken → unresponsive, Fix anything broken → Verify all checks pass

Two-tree model: docs/wiki/ (decisions) + docs/guide/ (procedural).
Single source of truth in colibri. clawdie-ai docs/public/ to be retired.
2026-06-26 09:16:43 +02:00

1.4 KiB
Raw Permalink Blame History

title description
ISO Install Bootable USB images for bare metal and offline installs.

Repo: https://codeberg.org/Clawdie/Clawdie-ISO Tags: https://codeberg.org/Clawdie/Clawdie-ISO/tags

This page covers image selection and USB writing. For the first-boot setup (setup.txt, the required lines, and what to expect), see First boot.

Download

Pick the image that matches your target:

  • Bare metal: desktop + offline packages for local installs
  • Cloud: headless image for VPS-style setups

Write the USB

Replace /dev/daX with the correct device. Use camcontrol devlist on FreeBSD or lsblk on Linux to confirm the target before writing.

sudo dd if=clawdie-iso-baremetal-DD.mmm.YYYY.img of=/dev/daX bs=1M status=progress

After flashing, either:

  • edit the first-boot setup (setup.txt) directly, or
  • run the optional inspect step first to collect disk/network facts into system.txt, system.env, inspect-facts.env, and suggested-setup.txt
  • optionally let inspect backfill blank install/storage values into setup.txt
  • optionally let inspect backfill blank hardware fields into system.env

Then boot. See First boot for the rest.

Customize or rebuild

If you need a custom package set or want to embed a specific Clawdie version, follow the build instructions in the Clawdie-ISO repo.