Eve library

Neith Linux Training Materials

Guide

Revision 1

On this page

Training path for engineers and operators working on @neith/linux.

Audience#

  • platform engineers extending flake, module, ISO, or crate behavior
  • operators validating images, updates, rollback, and recovery paths
  • contributors maintaining the self-hostability evidence chain

Learning Objectives#

  • understand the implemented flake, module, package, ISO, and Rust workspace layout
  • validate image, update, and rollback flows with reproducible commands
  • recognize when a Linux change impacts self-hostability, SBOM, or release evidence
  • document platform behavior clearly enough for downstream operators to verify

Curriculum#

Module 1: Workspace Orientation#

Walk the flake outputs, modules/neith/, iso/, packages/, and the crate workspace. Identify which layer owns platform policy, publishing, and recovery.

Module 2: Verification Workflows#

Practice the fast verification path for configuration changes and the deeper build/test path for behavior changes. Emphasize when to run nix-check versus full image validation.

Module 3: Recovery And Evidence#

Rehearse update, rollback, and recovery scenarios, then map the resulting evidence back to the self-hostability and support-oriented documentation.

Hands-On Labs#

  1. Run the standard build/test/lint/fmt/nix-check command set against the Linux workspace.
  2. Trace the recovery image and rollback path through the documented user flow.
  3. Update a Linux-facing doc and identify the certification or SBOM artifact that would need to change alongside it.

Assessment And Evidence#

Successful completion means the trainee can:

  • choose the correct verification target for a Linux change
  • explain the difference between workstation behavior, update orchestration, and recovery tooling in the current footprint
  • identify which Neith certification documents must move when Linux evidence changes

Commands Used In Training#

bash
pnpm nx run @neith/linux:build
pnpm nx run @neith/linux:test
pnpm nx run @neith/linux:lint
pnpm nx run @neith/linux:fmt
pnpm nx run @neith/linux:nix-check