myDevice/ventoy-setup.md

2.1 KiB

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: systemdudev und sd-vconsoleconsolefont 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:

{ "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)