Crucible is a tool for maintaining a fleet of Gentoo systems.
  • Rust 94.8%
  • Makefile 5.2%
Find a file
2025-07-24 15:52:28 -04:00
src Initial commit 2025-07-24 15:18:08 -04:00
.gitignore Initial commit 2025-07-24 15:18:08 -04:00
Cargo.lock Initial commit 2025-07-24 15:18:08 -04:00
Cargo.toml Initial commit 2025-07-24 15:18:08 -04:00
COPYING Initial commit 2025-07-24 15:18:08 -04:00
Makefile Initial commit 2025-07-24 15:18:08 -04:00
README.md Use a more accurate phrase 2025-07-24 15:52:28 -04:00

Overview

A Catalyst-like tool for managing a fleet of Gentoo systems.

Limitations

  • Only supports x86-64.
  • GCC & Clang are compiled against the greatest common instruction set among the supported microarchitectures.
    • The greatest common instruction set is x86-64-v2.
    • The supported microarchitectures are znver5, gracemont, skylake, and haswell.

Requirements

  • Rust
  • Btrfs
  • Make

Instructions

Create the required directory layouts:

$ sudo mkdir -p /var/lib/crucible/{binpkgs,confdirs,containers,repos}
$ ln -s /var/lib/crucible lib

Build the stage 3 images:

$ make bootstrap

Build the installer image:

$ make build-installer

Run tests:

$ make test

License

Licensed under AGPL-3.0-or-later.