Skip to content

firn

Install frostyard images with firn

firn installs snosi bootc OCI images onto a disk. Use the terminal wizard or graphical installer on the snosi installer ISO, or supply a TOML recipe for a headless install. Each method runs the same checks and installation pipeline.

Get started → Your first install

Installation erases the selected disk

Back up its data before you start. firn installs to a whole disk, not into free space beside an existing system. Every real install requires the exact target disk path as confirmation.

Choose how to install

  • Terminal wizard

    Run firn to choose an image, disk, security options and system settings. Review the generated recipe before you confirm.

  • Graphical installer

    Use firn-gui from the ISO's graphical boot entry. Its pages collect the same recipe fields, with keyboard shortcuts for every action.

  • Headless install

    Write a version-2 TOML recipe. Validate it, run preflight without disk changes, then install with typed disk confirmation.

  • Security choices

    Select unencrypted storage, a LUKS passphrase, or TPM2 auto-unlock. Secure Boot uses a separate MOK enrollment step.

Start here

  • 01 Install

    Boot the snosi installer ISO or install the CLI package.

  • 02 How firn works

    Understand recipes, preflight and the installation pipeline.

  • 03 Commands

    Look up installation, validation and detection options.

  • 04 Troubleshooting

    Find failure codes, diagnostics and known limits.

Pre-release

firn is pre-release software. The current recipe contract is bootc-only version 2. A/B images, legacy BIOS boot and ZFS root are not supported. This site describes the implemented installer, not a claim of completed hardware qualification.

firn is GPL-3.0-only software, derived from fisherman. See the repository's NOTICE for attribution.