# Ventoy VtoyBoot Setup

CachyOS wird als virtuelle Disk-Installation über Ventoy gebootet.

## Setup
- Ventoy mit VtoyBoot-Plugin
- vtoyboot.sh Pfad: `/home/chk/vtoyboot-1.0.36/vtoyboot.sh`
- BTRFS mit Subvolumes als Root-Dateisystem
- zram-Swap (kein physisches Swap-Device)
- EFI-Eintrag in `/etc/fstab` ist auskommentiert (existiert nicht in der virtuellen Disk)

## Pacman-Hook
- Pfad: `/etc/pacman.d/hooks/vtoyboot.hook`
- Führt vtoyboot.sh automatisch nach Kernel-Updates aus (linux-cachyos, linux-cachyos-lts + headers)
- Exec: `/bin/bash -c 'cd /home/chk/vtoyboot-1.0.36 && ./vtoyboot.sh'`

## mkinitcpio-Konfiguration
- HOOKS müssen `udev` statt `systemd` verwenden (sonst wird der ventoy-Hook nicht ausgeführt)
- `sd-vconsole` durch `consolefont` ersetzt
- `bash` in BINARIES (für ventoy-Hook Shebang)
- Aktuelle HOOKS: `(base udev autodetect microcode kms modconf block keyboard consolefont plymouth filesystems lvm2 ventoy)`

## Bekannte Probleme und Lösungen

### Boot hängt bei "A start job is running for /dev/disk/by-uuid/..."
**Ursache:** systemd-basiertes initramfs führt den ventoy `run_hook()` nicht aus → Root-Partition wird nicht gefunden.
**Lösung:** `systemd` → `udev` und `sd-vconsole` → `consolefont` in mkinitcpio HOOKS.

### vtoyboot.sh zeigt "Please run the script in the right directory"
**Ursache:** Script muss aus seinem eigenen Verzeichnis ausgeführt werden.
**Lösung:** `cd /home/chk/vtoyboot-1.0.36 && ./vtoyboot.sh`

### Boot hängt bei "Ventoy scanning files, please wait..."
**Ursache:** Ohne `VTOY_DEFAULT_SEARCH_ROOT` durchsucht Ventoy die gesamte Partition nach bootbaren Images — inkl. `projects/`, `$RECYCLE.BIN/` etc.
**Lösung:** In `ventoy/ventoy.json` den Scan-Pfad einschränken:
```json
{ "control": [{ "VTOY_DEFAULT_SEARCH_ROOT": "/ventoy/" }] }
```

## Checkliste bei Problemen
1. fstab: EFI-Mount auskommentiert?
2. mkinitcpio: `udev` statt `systemd`?
3. resume-Konfiguration: kein `resume=` in Kernel-Cmdline?
4. vtoyboot.sh nach letztem Kernel-Update ausgeführt?
5. initramfs enthält ventoy-Binaries? (`lsinitcpio | grep ventoy`)