34043086b9
BOS opts in to bakery's system prefix so desktop apps live on @ and ride snapper/grub-btrfs snapshots. The builder home stays ~/.local; build-local.sh copies bins, share/data, and user units onto the image. Per-user installed.json and the index cache stay in skel. Recovery is still grub-btrfs, not snapper rollback.
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# Hardware and recovery
|
|
|
|
## GPUs
|
|
|
|
BOS ships the generic **Mesa** stack. AMD and Intel work out of the box.
|
|
|
|
**NVIDIA is unsupported.** The proprietary driver is not included, NVIDIA
|
|
firmware is not on the image, and there is no Hyprland NVIDIA env wiring.
|
|
Installing `nvidia` / `nvidia-utils` after the fact is not a product path.
|
|
|
|
On first graphical login, `bos-first-boot` probes `lspci` / `/proc` and,
|
|
if an NVIDIA GPU is present, writes `~/.local/state/bos/nvidia-offer.json`
|
|
and notifies that the proprietary driver is not on the ISO. It does **not**
|
|
install anything. bos-settings can grow a panel that reads that file later.
|
|
|
|
The same probe leaves a HiDPI hint at `~/.local/state/bos/hidpi-hint.json`
|
|
when scale > 1 or the panel is dense; it never rewrites `monitors.json`.
|
|
A VM without `/dev/dri` gets a notification only.
|
|
|
|
## Recovery
|
|
|
|
An update that breaks the system is recovered from the **GRUB "snapshots"
|
|
submenu** (grub-btrfs), not `snapper rollback`.
|
|
|
|
BOS GRUB pins `rootflags=subvol=@`. `snapper rollback` swaps the default
|
|
subvolume; the installed `grub.cfg` will still boot `@`. Pick the grub-btrfs
|
|
entry so the kernel command line matches the snapshot you want. Bakery
|
|
desktop apps live under `/usr/local` on `@`, so those same snapshots
|
|
include them.
|
|
|
|
If the system will not boot (lost EFI entry / broken GRUB), boot the live
|
|
ISO and run `sudo bos-rescue`. It mounts `@` + the ESP and offers the same
|
|
`grub-install` NVRAM + `--removable` sequence as `post-install.sh`.
|
|
|
|
A/B root swapping is not implemented. See the README Recovery section.
|