# Install bootvine always shows stage 2 and shutdown. To show the boot from the initrd as well, the initrd has to run systemd. ## NixOS 1. Add the flake to your system flake's inputs and pass its module in: ```nix { inputs.bootvine = { url = "git+https://codeberg.org/wvhulle/bootvine"; inputs.nixpkgs.follows = "nixpkgs"; }; outputs = { nixpkgs, bootvine, ... }: { nixosConfigurations.my-host = nixpkgs.lib.nixosSystem { modules = [ bootvine.nixosModules.default ./configuration.nix ]; }; }; } ``` 2. Enable it in `configuration.nix`: ```nix { services.bootvine.enable = true; } ``` The initrd is a systemd initrd by default since NixOS 26.05, and the only kind after it. On NixOS 25.11 and earlier, also set `boot.initrd.systemd.enable = true` to show the boot from the initrd. 3. Rebuild and reboot: ```sh sudo nixos-rebuild switch --flake .#my-host ``` ## Ubuntu 1. Install the build dependencies and Rust. The repository pins a nightly toolchain in `rust-toolchain.toml`, which rustup fetches on the first build: ```sh sudo apt install build-essential pkg-config libdbus-1-dev git curl curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh ``` 2. Clone, build and install the binary and the systemd units, and enable them. `cargo xtask install` builds as you and asks `sudo` only for the copying and `systemctl enable`: ```sh git clone https://codeberg.org/wvhulle/bootvine.git cd bootvine cargo xtask install ``` This installs `/usr/bin/bootvine`, and `bootvine.service` and `bootvine-shutdown.service` in `/usr/lib/systemd/system`, which is enough for stage 2 and shutdown. 3. Optionally, show the boot from the initrd. This needs a dracut initramfs with systemd in it; initramfs-tools has no systemd, so on releases that use it bootvine starts in stage 2 only. ```sh cargo xtask install --initrd dracut sudo dracut --force ``` This adds the dracut module in `/usr/lib/dracut/modules.d/90bootvine` and enables it in `/etc/dracut.conf.d/bootvine.conf`. 4. Reboot. ## Other distributions Install as in the Ubuntu steps, with your distribution's packages for a C toolchain, `pkg-config` and the libdbus headers. For the initrd, use the dracut module as above, or on mkinitcpio: 1. Install the hook in `/usr/lib/initcpio/install/sd-bootvine`: ```sh cargo xtask install --initrd mkinitcpio ``` 2. Add `sd-bootvine` after `systemd` in `HOOKS` in `/etc/mkinitcpio.conf`. 3. Rebuild the initramfs: ```sh sudo mkinitcpio -P ``` ## Packaging `cargo xtask install --destdir ` stages the files under `` instead of the root, and combines with `--initrd`. ## Uninstall `cargo xtask uninstall` removes everything `cargo xtask install` put in place. On NixOS, remove `services.bootvine.enable` and rebuild.