Files
bootvine/README.md
T
Willem Vanhulle 7e95cbd8e9 feat: show why units failed, with their last journal lines
Failed jobs keep their kind: units that broke or timed out get a failure
panel entry with the reason systemd reports (exit status, signal, timeout,
start limit, status text) and their last journal lines read through
libsystemd. Units that failed only through a dependency are dimmed and left
out of the panel, and units that crash after starting count as failed.

Restructure the repository around this:
- move the library and binary into bootvine/ and the scripted demos into
  their own unpublished scripted-demos crate, with their VHS tapes
- move the crane builds and NixOS module into nix/
- group each sample VM with its check under vm-tests/, adding text-console,
  scripted-initrd, encrypted-volume and failures machines and a vm-failures
  check
- add docs/guide.md walking through the screen with every recording, keep
  one recording in the README, and re-render all recordings
2026-10-30 14:59:10 +01:00

61 lines
2.6 KiB
Markdown

# bootvine
A live tree of systemd jobs on the boot console, in the spirit of
[nix-output-monitor](https://github.com/maralorn/nix-output-monitor). It
replaces the scrolling kernel and systemd lines with the units still pending
and, in the room the tree leaves, a timeline of the slowest ones that ran.
I started bootvine out of frustration with the boot screen of most Linux
distributions: a wall of log lines scrolling past too fast to read, which never
gave me any idea of what was going on.
<img src="https://codeberg.org/wvhulle/bootvine/raw/branch/main/recordings/boot.gif" width="691" alt="A boot through the initrd into stage 2, with one failed unit">
It also follows shutdowns, answers passphrase prompts such as a
[LUKS](https://gitlab.com/cryptsetup/cryptsetup) unlock in place, and shows why
a unit failed with its last journal lines. The
[guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md)
walks through each part of the screen.
## Requirements
- systemd ≥ 246 as PID 1
- [libdbus](https://www.freedesktop.org/wiki/Software/dbus/) and libsystemd
- a virtual terminal
- a systemd initrd, to show the boot from the initrd as well as stage 2
See [Install](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/install.md)
for each distribution.
## Try it without installing
With [Nix](https://nixos.org/download/), boot a sample [NixOS](https://nixos.org) machine with slow and
failing units in a [QEMU](https://www.qemu.org) window, without touching your
system's boot:
```sh
nix run git+https://codeberg.org/wvhulle/bootvine#sample-vm-slow-services
```
It logs in as root; `poweroff` shows the shutdown. The
[guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md#trying-it)
lists the other sample machines and the scripted demos that play in a terminal.
## Documentation
- [Guide](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/guide.md)
to the screen: the tree, the timeline, failures, shutdown and passphrase
prompts.
- [Install](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/install.md)
on NixOS, Ubuntu and other distributions.
- [Configuration](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/configuration.md)
of colours, timing and the console.
- [Architecture](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/architecture.md):
how bootvine follows the boot and takes the console.
- [Development](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/development.md)
and the [code style](https://codeberg.org/wvhulle/bootvine/src/branch/main/docs/style.md).
## License
[GPL-3.0-or-later](https://codeberg.org/wvhulle/bootvine/src/branch/main/LICENSE).