Skip to content

ISO Install

Repo: https://codeberg.org/Clawdie/Clawdie-ISO Releases: https://codeberg.org/Clawdie/Clawdie-ISO/releases

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

Pick the image that matches your target:

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

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

Terminal window
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.

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