Fruix

fruix is the canonical Fruix repo/channel.

This repo is the long-lived source of truth for Fruix package, system, installer, deployment, and node-management logic.

Scope

Canonical Fruix content belongs here:

• package definitions
• system definitions
• source and promotion logic
• installer artifacts and future TUI installer
• deployment and installed-node lifecycle logic
• long-lived metadata formats

fruix-bootstrap is separate and only exists to turn a plain FreeBSD host into a Fruix builder that can evaluate and materialize this repo.

Original channel URL

The baked-in original channel URL is:

• https://git.teralink.net/self/fruix.git

Bootstrap wrappers may default to that origin while local development uses a sibling checkout such as:

• ../fruix

Current layout

• bin/fruix — direct checkout entrypoint when dependencies are already available
• scripts/fruix.scm — canonical CLI implementation
• modules/fruix/... — canonical Fruix modules

The direct checkout entrypoint now also prefers a prepared builder root at:

• ~/.local/opt/fruix-builder

when fruix-bootstrap has already prepared one.

Guides

• docs/self-hosted-dev.md — build the self-hosted development installer ISO and prepare an installed Fruix node for development work

Intended lifecycle

plain FreeBSD
  -> fruix-bootstrap
      -> Fruix builder
          -> pinned fruix checkout
              -> build Fruix artifacts
                  -> booted Fruix node
                      -> future lifecycle managed by fruix