Installation guide
1. Download the ISO
Go to the download page and choose your distro: Marsh, Pup or Snout.
2. Flash to a USB drive
You'll need a USB drive with at least 4 GB. Use one of these tools:
- Balena Etcher (Windows, macOS, Linux) — easiest option
- Ventoy (Windows, Linux) — lets you keep multiple ISOs on the same drive
- dd (Linux/macOS, via terminal):
sudo dd if=capivaraos-marsh-1.x.x.iso of=/dev/sdX bs=4M status=progress
!!! warning "Be careful with dd"
Check the correct device with lsblk before running the command. Overwriting the wrong device is irreversible.
3. Boot from USB
Restart your computer and enter the boot menu (usually F12, F2 or Del during startup). Select the USB drive.
4. Try or install
When it boots, you'll see the option to enter live mode (try without installing) or start the installation directly.
5. Follow the Anaconda installer
CapivaraOS uses the Anaconda installer, the same one used by Fedora. It will guide you through:
- Language selection (pre-configured as Brazilian Portuguese)
- Disk partitioning
- User account creation
- Installation
6. Done
After installation, remove the USB drive and reboot. The system comes pre-configured in Portuguese, with the desktop environment ready to use.
Hit a problem? Post on the forum or open an issue on GitHub.