| Commit message (Collapse) | Author | Age | Files | Lines |
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
This is a major change that replaces the GRUB bootloader with ZFSBootMenu,
providing native ZFS boot environment support.
Key changes:
- EFI partition reduced from 1GB to 512MB (only holds ZFSBootMenu)
- EFI now mounts at /efi instead of /boot
- Kernel and initramfs live on ZFS root (enables snapshot boot with matching kernel)
- Downloads pre-built ZFSBootMenu EFI binary from get.zfsbootmenu.org
- Creates EFI boot entries for all disks in multi-disk configurations
- Syncs ZFSBootMenu to all EFI partitions for redundancy
- Sets org.zfsbootmenu:commandline on zroot/ROOT for kernel cmdline inheritance
- Sets bootfs pool property for default boot environment
- AMD GPU workarounds (pg_mask, cwsr_enable) added to kernel cmdline when AMD detected
Deleted GRUB snapshot tooling (no longer needed):
- custom/grub-zfs-snap
- custom/40_zfs_snapshots
- custom/zz-grub-zfs-snap.hook
- custom/zfs-snap-prune
Updated helper scripts:
- zfssnapshot: removed grub-zfs-snap call, shows ZFSBootMenu tip
- zfsrollback: removed grub-zfs-snap call, notes auto-detection
Tested configurations:
- Single disk installation
- 2-disk mirror (mirror-0)
- 3-disk RAIDZ1 (raidz1-0)
- All boot correctly with ZFSBootMenu
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Root cause: Missing/outdated linux-firmware broke AMD Strix Halo GPU init.
Fixed by installing linux-firmware 20260110-1.
Changes:
- install-archzfs: Fix mkinitcpio config (remove archiso.conf, fix preset)
- todo.org: Add ZFS rollback + /boot mismatch issue, recommend ZFSBootMenu
- docs/2026-01-22-ratio-boot-fix-session.org: Full troubleshooting session
- docs/2026-01-22-mkinitcpio-config-boot-failure.org: Bug report
- assets/: Supporting documentation and video transcript
Key learnings:
- AMD Strix Halo requires linux-firmware 20260110+
- ZFS rollback with /boot on EFI partition can break boot
- zpool import -R can permanently change mountpoints
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Three bugs were preventing installed systems from booting:
1. ZFS package preset (50-zfs.preset) enables zfs-import-cache by default,
overriding our attempt to use zfs-import-scan. Now explicitly disable
zfs-import-cache before enabling zfs-import-scan.
2. zfs-import-scan has ConditionFileNotEmpty=!/etc/zfs/zpool.cache which
prevents it from running if cachefile exists. Now remove cachefile after
setting cachefile=none.
3. GRUB_CMDLINE_LINUX contained root=ZFS=... but grub-mkconfig also
auto-detects ZFS root, causing duplicate root= parameters. Removed
manual root= since grub-mkconfig handles it correctly.
All 22 tests pass (19 sanity + 3 installation configs).
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Switch to the recommended pool import method that uses blkid to scan
for pools instead of relying on zpool.cache. This eliminates the
complexity of managing cachefile paths with altroot during installation.
Changes:
- Remove cachefile setup from create_zfs_pool() and configure_zfs_services()
- Enable zfs-import-scan.service instead of zfs-import-cache.service
- Set cachefile=none on the pool since it's not needed
- Update full-test.sh to verify zfs-import-scan is enabled
This approach is recommended per the Arch Wiki and doesn't require
the cachefile to be present in the initramfs.
|
| |
|
|
|
|
|
| |
- Add zpool set cachefile=/etc/zfs/zpool.cache after pool creation
- Without this, initramfs ZFS hook can't import pool at boot
- Causes "cannot import '(null)': no such pool available" error
- Add cachefile property test to full-test.sh
|
| |
|
|
|
|
|
|
| |
Install avahi and nss-mdns packages, enable avahi-daemon service.
Matches archsetup's implementation for consistency.
After installation, systems are accessible as <hostname>.local
(e.g., ratio.local, framework.local) for easier SSH access.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Root cause: The `hostid` command returns a value even without /etc/hostid,
but `zgenhostid` generates a DIFFERENT random value. The install script
was calling `hostid` for the GRUB kernel parameter, then later calling
`zgenhostid` to create /etc/hostid - resulting in a mismatch.
ZFS refuses to auto-import pools when spl.spl_hostid doesn't match
/etc/hostid, causing "Failed to mount /sysroot" at boot.
Fix: Generate hostid with zgenhostid FIRST (in configure_bootloader),
then read the consistent value for the GRUB kernel parameter. The
configure_zfs_services function now just copies the already-existing
/etc/hostid to the installed system.
Verified in VM: GRUB and /etc/hostid both show identical values after
installation.
|
| |
|
|
|
|
|
| |
- Add avahi and nss-mdns packages to live ISO
- Enable avahi-daemon.service for mDNS discovery
- Set hostname to "archzfs" so machines are accessible at archzfs.local
- Fix ISP firmware path in install-archzfs: remove /mnt prefix for chroot
|
| | |
|
| | |
|
| | |
|
| | |
|
| |
|
|
|
|
|
| |
- Add scripts/full-test.sh for automated install testing (single, mirror, raidz1)
- Add --full-test option to build-release workflow
- Install zfssnapshot and zfsrollback to target system during install
- Simplify .gitignore to exclude entire vm/ directory
|
| |
|
|
|
|
| |
Sort datasets by path depth (deepest first) before rolling back.
ZFS requires children to be rolled back before their parents,
otherwise rollback can fail or skip datasets.
|
| |
|
|
|
|
|
|
|
| |
Remove backslash escape from grub-probe command substitution so it
executes at config generation time instead of writing the literal
string "$(grub-probe ...)" into grub.cfg.
GRUB's scripting language doesn't support bash-style $() command
substitution, causing syntax errors on boot.
|
| |
|
|
|
| |
40% was too small on console, showing only ~2 lines.
70% gives roughly 2/3 of screen for snapshot selection.
|
| |
|
|
|
| |
Required for zfsrollback interactive snapshot selection to work
on freshly installed systems before archsetup runs.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Copied from archsetup to make these tools available on the live ISO
for rescue scenarios and post-install management.
zfssnapshot:
- Creates recursive snapshots across all pools
- Timestamps with descriptive labels (YYYY-MM-DD_HH-MM-SS_description)
- Integrates with grub-zfs-snap for boot menu updates
zfsrollback:
- Interactive fzf-based snapshot selection
- Two modes: single dataset or all matching datasets
- Safety warnings showing what will be destroyed
- Special genesis rollback warning
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Add bpftrace, bcc-tools, and perf for system tracing and profiling.
These are Linux's eBPF-based equivalents to DTrace, essential for
debugging and performance analysis in rescue scenarios.
Add w3m terminal browser alongside existing lynx for better rendering
of complex pages.
Update RESCUE-GUIDE.txt with new sections covering:
- Section 9: System Tracing with bpftrace examples, BCC tools, perf
- Section 10: Terminal web browsing with lynx/w3m basics
|
| |
|
|
|
|
|
|
| |
Used $EFI_PART (undefined) instead of ${EFI_PARTS[0]} when
generating fstab, resulting in empty/wrong UUID for /boot mount.
This caused "Timed out waiting for device /dev/disk/by-uuid"
on boot of newly installed systems.
|
| |
|
|
|
|
|
|
|
|
|
|
| |
The autodetect hook filters modules based on currently loaded hardware,
which when running from a live ISO means the target system's storage
drivers (NVMe, AHCI, etc.) may not be included in the initramfs.
This caused boot failures on bare metal with "Timed out waiting for
device /dev/disk/by-uuid" because the disk controller wasn't detected.
Removing autodetect includes all storage drivers, making the initramfs
larger but ensuring compatibility with any hardware configuration.
|
| | |
|
| | |
|
| |
|
|
|
|
|
|
|
| |
Add get_encryption_choice() to ask user whether to enable encryption
during interactive install. Remove --no-encrypt CLI flag in favor of
config file NO_ENCRYPT option for unattended installs. Update tests
to rely on config file setting instead of flag.
Also: fix ISO label to ARCHZFS for stable GRUB entries, add TODO items.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added:
- iotop: disk I/O monitor by process
- ncdu: interactive disk usage analyzer
- tree: directory tree viewer
- speedtest-cli: internet speed test
- mosh: mobile shell (survives disconnects)
- aria2: multi-protocol downloader with resume
- tmate: terminal sharing for remote assistance
- sshuttle: VPN over SSH
- pass: password manager
Rescue guide expanded:
- Section 5: iotop for finding disk I/O culprits
- Section 6: ncdu and tree for disk space analysis
- Section 7: speedtest-cli, mosh, aria2, tmate, sshuttle
- Section 8: pass password manager access
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added:
- mtr: combined ping + traceroute
- iperf3: bandwidth testing
- iftop: live bandwidth monitor by connection
- nethogs: bandwidth monitor by process
- ethtool: NIC configuration and diagnostics
- tcpdump: packet capture
- bind: dig/nslookup DNS tools
- nmap: network scanner
- wireshark-cli: tshark packet analysis
Rescue guide section 7 expanded with scenarios for:
- Network path analysis with mtr
- Bandwidth testing with iperf3
- Live monitoring with iftop and nethogs
- Interface diagnostics with ethtool
- Packet capture with tcpdump
- Network scanning with nmap
- Deep packet analysis with tshark
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added:
- partimage: legacy partition imaging
- f2fs-tools: Flash-Friendly FS support
- exfatprogs: exFAT filesystem tools
- emacs: editor
Rescue guide sections 6-8:
- Disk Operations: partclone, fsarchiver, nwipe, filesystem tools
- Network Troubleshooting: connectivity, sshfs, file transfers
- Encryption & GPG: symmetric/asymmetric decryption, LUKS, eCryptfs
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added:
- memtester: userspace memory testing
- stress-ng: CPU/memory/IO stress testing
- lm_sensors: temperature/fan/voltage monitoring
- lshw: detailed hardware inventory
- dmidecode: SMBIOS/DMI system information
- nvme-cli: NVMe drive management
- hdparm: HDD/SSD parameter tuning
Rescue guide Section 5 covers:
- SMART disk health monitoring
- Memory testing with memtester
- System stress testing
- Temperature monitoring with sensors
- Hardware inventory commands
- Disk benchmarking
- Bad block checking
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added: chntpw, ntfs-3g, dislocker, hivex
Rescue guide section 4 covers:
- Mounting NTFS partitions (including hibernated)
- Reset/blank Windows passwords with chntpw
- Unlock disabled accounts, promote to admin
- Access BitLocker drives with dislocker
- Copy files from non-booting Windows
- Edit Windows registry with hivex
- Offline malware scanning with ClamAV
- Disable Fast Startup from Linux
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added: os-prober, syslinux, ms-sys
Rescue guide section 3 covers:
- Chroot into broken system (including ZFS)
- Reinstall GRUB (UEFI and Legacy)
- Fix UEFI boot entries with efibootmgr
- Rebuild initramfs with mkinitcpio
- Dual-boot GRUB/Windows with os-prober
- Restore Windows MBR with ms-sys
- ZFS-specific boot issues (hostid, hooks)
- Emergency GRUB command line boot
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Packages added: ddrescue, testdisk, foremost, sleuthkit, safecopy, smartmontools
Rescue guide section 2 covers:
- SMART health assessment
- ddrescue for cloning failing drives
- PhotoRec/TestDisk for file/partition recovery
- Foremost for file carving
- Filesystem repair (ext4, NTFS, XFS, FAT)
- Mounting disk images
- Safecopy for very damaged media
|
| |
|
|
|
|
|
| |
- Add tealdeer, pv, rsync, mbuffer, lsof to ISO packages
- Pre-populate tealdeer cache during build for offline tldr
- Create RESCUE-GUIDE.txt with comprehensive ZFS recovery section
- Copy rescue guide to /root/ on ISO
|
| |
|
|
|
|
|
|
|
|
|
| |
Allows CI/CD testing without ZFS encryption passphrase prompts:
- --no-encrypt flag on command line
- NO_ENCRYPT=yes in config file
- Skips passphrase prompt in interactive mode
- Creates pool without encryption options
This enables fully automated VM testing without needing to
enter passphrase at boot time.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Implements hybrid retention policy:
- Always keep 20 most recent snapshots
- Delete snapshots beyond #20 only if older than 180 days
- Genesis snapshot is always protected
Features:
- zfs-snap-prune script with --dry-run, --test, --verbose modes
- Comprehensive test suite (22 tests)
- Runs automatically after pacman operations
- Daily systemd timer for cleanup
- Regenerates GRUB menu after pruning
This prevents unbounded snapshot growth while preserving
recent history and the genesis snapshot.
|
| |
|
|
|
|
|
|
|
|
| |
Add ability to boot into ZFS snapshots directly from GRUB menu:
- grub-zfs-snap: generates GRUB submenu entries for recent snapshots
- 40_zfs_snapshots: GRUB generator script installed to /etc/grub.d/
- zz-grub-zfs-snap.hook: pacman hook for automatic GRUB regeneration
The GRUB menu automatically updates after kernel/ZFS package changes.
Up to 10 most recent snapshots appear in a "ZFS Snapshots" submenu.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Bug fixes:
- Fix depmod using wrong kernel version during initramfs generation
The script now explicitly specifies the installed kernel version
instead of relying on uname -r (which returns the live ISO kernel)
- Add kernel module verification before mkinitcpio
- Add hostid 0x prefix to spl.spl_hostid kernel parameter
ISO naming:
- Changed format to: archzfs-vmlinuz-{version}-lts-{date}-{arch}.iso
- Example: archzfs-vmlinuz-6.12.65-lts-2026-01-18-x86_64.iso
test-vm.sh:
- Add QEMU monitor socket for automation support
|
| |
|
|
|
|
|
|
|
| |
Bug: In gather_input(), the line `[[ -n "$WIFI_SSID" ]] && info "..."`
returns exit code 1 when WIFI_SSID is empty. The subsequent bare
`return` inherits this exit code, causing the script to exit
with set -e.
Fix: Use explicit `return 0` to ensure gather_input returns success.
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
Features:
- --config-file option for automated installs
- Example config at /root/install-archzfs.conf.example
- Validates required fields before install
- Config only used when explicitly specified (safety)
Bug fixes:
- Fix pacstrap hanging on provider prompts (use yes pipe)
- Remove fsck from mkinitcpio HOOKS (ZFS doesn't use fsck)
- Add hostid support for ZFS boot
- Add spl.spl_hostid to kernel command line
Documentation:
- Comprehensive README.org with 15 sections
- Session context tracking file
|
| | |
|
| |
|
|
|
|
|
| |
- Fix disk selection awk parsing for empty MODEL field
- Add fzf-based WiFi network selection with signal/security preview
- Remove pre-filter on locale/keymap so all options visible
- Add helpful header hints for searching
|
| |
|
|
|
|
|
|
|
|
| |
- Timezone: fuzzy search with current time preview
- Locale: fuzzy search with format examples
- Keymap: fuzzy search with layout info
- Disk selection: multi-select with disk details preview
- RAID level: explanatory preview with capacity calculations
Provides consistent, searchable interface with inline documentation.
|
| | |
|
| |
|
|
|
|
|
|
|
|
|
| |
- Multi-disk RAID support: mirror, stripe, raidz1/2/3
- EFI partitions on all disks for boot redundancy
- SSH configuration prompt (default yes) with sshd enabled
- Stripe option for max capacity without redundancy
- Genesis snapshot with rollback-to-genesis script
- NetworkManager added to ISO for WiFi config
- Remove color codes for better terminal compatibility
- archsetup launcher via curl
|
|
|
Build scripts for creating custom Arch Linux ISO with ZFS support.
Includes installer scripts and VM testing setup.
|