Talk:Install Arch Linux on ZFS
replace writehostid with zgenhostid?
Since a few versions zfs now comes with a tool to write a hostid to /etc/hostid. Should we recommend using it instead of the provided C code?
Charlesmilette (talk) 22:32, 2 January 2018 (UTC) Charles Milette
base metapackage change and ALEZ script
With the changes to `base` and looking at ALEZ, it looks as though ALEZ may not be up to date with the metapackage change which could potentially lead to an unbootable system. Is there any confirmation that ALEZ still works?
Johncrist1988 (talk) 04:34, 16 October 2019 (UTC)
It should be working as is since the current release from last month was before the base change, however I will update the script accordingly and release new ISO.
Johnramsden (talk) 05:07, 16 October 2019 (UTC)
do not create encrypted zroot as base pool but z/root
If you follow the suggestions on encryption one ends up with not being able to use ZFS's send/recv of all child datasets, without the drawback, that a encryption key needs to be loaded for each dataset (when they are send one by one). The reason is, that the dataset zroot is created due to the zpool creation and therefor it is read only. When you want to receive a (recusive) raw-data stream (which is IMO the only option) it can not take place on the existing zroot (even with recv -F option). Since rootfs is anyhow not suggested to reside on zroot but zroot/ROOT/default, I think think a layout like an unencrypted z pool with a residing encrypted z/root filesystem would be best option that can be send away in order to clone a complete system (e.g. desktop setup).
Einsiedlerkrebs (talk) 13:25, 14 November 2022 (UTC)
Update partition scheme for separate boot pool, root pool and swap partition
As the current situation stands, GRUB severely lags behind OpenZFS development. Many features need to be disabled on the pool which GRUB will boot from.
OpenZFS official guide has adopted the approach of creating separate boot pool (mounted at /boot) and root pool (mounted at /) since at least Debian Stretch days.
A separate swap partition is also recommended over swap on zvol to avoid deadlocks.
I've completed a guide for Root on ZFS here, containing the above fixes.
One might argue why don't just mount esp at /boot, here's my argument: with /boot on a ZFS pool, it is possible to select initramfs from a ZFS snapshot in GRUB, which enables recovery from a faulty initramfs. If stored in esp, there's no way to rescue a system with bad initramfs, or do a full system rollback to a previous state, as contents in /boot is not protected by ZFS.
rozb3-pacAUR relies on separate boot and root pools to perform a full system rollback.
M0p (talk) 16:38, 24 December 2020 (UTC)
Add bootloader method ZfsBootMenu
Hi,
Since I broke my grub-compatibility by accidentally enabling a zfs feature which is not supported by grub, I looked for alternative methods to boot a ZFS root pool I found zfsbootmenu https://zfsbootmenu.org/ which is IMHO the best way to boot a ZFS (EFI only?):
- Just drop the zfsbootmenu.EFI file from https://github.com/zbm-dev/zfsbootmenu/releases in a EFI subdirectory on your EFI Partition and configure your NVRAM with efibootmgr to use that file
- You now get a menu which finds all pools and boot environments, provides an emergency shell (with zfs tools) and a nice menu which allows for cloning/booting older snapshots and much more
- It works with probably every ZFS feature because it boots a complete kernel with ZOL enabled.
I am new to writing wiki entries and I don't have the rights to modify this article, (which is probably a good idea) but maybe any of you arch-zfs-enthusiasts can look into zfsbootmenu and confirm that it is what we are all looking for.
More detailed instructions (may be used to include in the wiki):
Install ZFS Boot Menu
#mount your EFI Partition mount /dev/sdXY /efi #create subfolder for ZBM mkdir -p /efi/EFI/zbm #download the latest release from https://github.com/zbm-dev/zfsbootmenu/releases wget https://github.com/zbm-dev/zfsbootmenu/releases/download/v1.10.1/zfsbootmenu-x86_64-v1.10.1.EFI -O /efi/EFI/zbm/zfsbootmenu.EFI #add entry to your bootmenu efibootmgr --disk /dev/sdX --part Y --create --label "ZFSBootMenu" --loader '\EFI\zbm\zfsbootmenu.EFI' --unicode "spl_hostid=$(hostid) zbm.timeout=3 zbm.prefer=zroot zbm.import_policy=hostid" --verbose
you can probably also just name the file /efi/EFI/BOOT/BOOTX64.EFI on an EFI partition of an USB stick in order to make it bootable without a custom NVRAM entry (https://blog.uncooperative.org/blog/2014/02/06/the-efi-system-partition/)
Configure ZFS Boot Menu In order to keep your current kernel parameters, you should set them as zfs property **org.zfsbootmenu:commandline** on the bootfs, but exclude the root and bootfs parameters
#lookup your current commandline cat /proc/cmdline -> zfs=zroot/ROOT/arch noresume init_on_alloc=0 rw spl.spl_hostid=0xdeadbeef #set the property without the zfs parameters zfs set org.zfsbootmenu:commandline="noresume init_on_alloc=0 rw spl.spl_hostid=0xdeadbeef" zroot/ROOT
Pitfalls
- If your ZFS root is readonly after boot this make sure you have the parameter **rw** in your commandline (you can set this interactively in the menu for one boot, but you should configure the org.zfsbootmenu:commandline property as mentioned above
- If you are booting into an old snapshot and the system does not boot at all you probably have the https://wiki.archlinux.org/title/ZFS#Using_zfs-mount.service enabled which mounts your current rootfs over your snapshottet rootfs. In order to avoid that make sure you set the zfs canmount property to noauto on the root filesystem (which is mounted by the kernel anyway)
—This unsigned comment is by Thomas.oster (talk) 08:38, 16 July 2021 (UTC). Please sign your posts with ~~~~!
- Thomas, I think you don't have rights to edit the article because you still don't have the 20 edits needed to become an autoconfirmed user. Regarding `zfsbootmenu`, that's very interesting and helpful, indeed, thank you! I don't have yet that much experience with EFI, otherwise I would've helped myself. My initial impression is that a well-tested AUR package with, among other things, proper initcpio support, may be rather helpful here, otherwise some less experienced or overly enthusiastic users might get themselves in trouble (many of us have at one point or another been guilty of "boldly testing in production", though fewer will probably openly admit to it :D).
— Kerberizer • T/C 10:47, 16 July 2021 (UTC)
- I could provide an AUR package, but it is not so easy, because the EFI directory is not mounted on every system and not on the same mountpoint. Also an AUR package writing to the NVRAM on installation does not feel right. However if some people using ZFS root and EFI could just test it by booting from an USB Stick containing ZFS Boot menu, we could add the proper process to the wiki as an alternative to GRUB and create a standard way with defined names and mountpoints.
Thomas.oster (talk) 06:35, 29 September 2021 (UTC)
- I could provide an AUR package, but it is not so easy, because the EFI directory is not mounted on every system and not on the same mountpoint. Also an AUR package writing to the NVRAM on installation does not feel right. However if some people using ZFS root and EFI could just test it by booting from an USB Stick containing ZFS Boot menu, we could add the proper process to the wiki as an alternative to GRUB and create a standard way with defined names and mountpoints.
- Thomas, I think that an AUR package with just the EFI binary might indeed be okay as a start, together, as you suggest, with an additional information on the wiki on how to actually use it (not unlike packages like edk2-shell).
- There is something that bothers me a little bit, though, in particular if ZBM's EFI binary is used. Their latest release, for example, is built with Linux 5.12.14 and ZFS 2.1.0. The kernel version is fine for the task, I guess, but the ZFS version apparently might lag a bit behind upstream OpenZFS. Perhaps the ZBM developers will be diligent enough to publish new releases as new ZFS versions come out (latest is 2.1.1, but let's say it's okay to skip it, as it is only a patch-level release). Still, that's something that one should perhaps be mindful of; even more so if using the
zfs*-git
packages. Of course, problems would arise only if new and incompatible ZFS features are introduced, but in the end that's what has also been breaking Grub at different times.
- There is something that bothers me a little bit, though, in particular if ZBM's EFI binary is used. Their latest release, for example, is built with Linux 5.12.14 and ZFS 2.1.0. The kernel version is fine for the task, I guess, but the ZFS version apparently might lag a bit behind upstream OpenZFS. Perhaps the ZBM developers will be diligent enough to publish new releases as new ZFS versions come out (latest is 2.1.1, but let's say it's okay to skip it, as it is only a patch-level release). Still, that's something that one should perhaps be mindful of; even more so if using the
- This actually is the reason why for my own systems -- I've been resisting UEFI for years, but recently realized it's high time to abandon BIOS/CSM -- I've chosen an extremely simplistic and hopefully foolproof approach: systemd-boot, an EFI partition on each disk in the root pool, and a path-activated service that copies the kernel, initramfs, firmware, EFI shell, etc. to each EFI partition (mostly following some of the suggestions in systemd-boot). But, of course, I don't use boot environments, which is the main point of ZBM, and which I'm sure many people find useful or even necessary for their own tasks. On a side note, the boot process in Linux probably needs a general refresh, especially in terms of security -- it was interesting to read Poettering's opinion these days. That's quite a different topic, of course, yet I've also been thinking how ZFS would fit in such changes, which might happen one day whether we like them or not, much like systemd did. </offtopic>
- As for possible testing, I might be able to do some, but since ZBM, sadly, seems to not fit that well my needs, I hope other people, who would actually use it, will step in.
— Kerberizer • T/C 11:46, 29 September 2021 (UTC)
- As for possible testing, I might be able to do some, but since ZBM, sadly, seems to not fit that well my needs, I hope other people, who would actually use it, will step in.
- Kerberizer You are right about the ZFS version problem. That's why I created a docker image which builds the ZBM efi binary: https://github.com/zbm-dev/zfsbootmenu/pull/193. But this still depends on the packages of void linux. They promised they will be nearly instant up to date, but it would be of cause better if that AUR package would build an EFI binary from the currently installed arch packages (similar as DKMS). I personally copy my kernel and initramfs to the EFI partition automatically and boot it directly as efi stub, but if I ever need to rollback or temporarily boot an old snapshot, I can boot zfs boot menu and just select the snapshot, which always contains the kernel and initramfs which was pesent at that time.
Thomas.oster (talk) 12:00, 29 September 2021 (UTC)
- Kerberizer You are right about the ZFS version problem. That's why I created a docker image which builds the ZBM efi binary: https://github.com/zbm-dev/zfsbootmenu/pull/193. But this still depends on the packages of void linux. They promised they will be nearly instant up to date, but it would be of cause better if that AUR package would build an EFI binary from the currently installed arch packages (similar as DKMS). I personally copy my kernel and initramfs to the EFI partition automatically and boot it directly as efi stub, but if I ever need to rollback or temporarily boot an old snapshot, I can boot zfs boot menu and just select the snapshot, which always contains the kernel and initramfs which was pesent at that time.
- Thomas, ah, it's obvious how I still lack experience with UEFI and forget that it's much easier to boot different things—from UEFI itself, from an EFI shell, etc. :D One maybe stupid question comes to mind: how much additional value has ZBM over a live ISO with ZFS? I suppose booting from a snapshot is certainly one thing that you cannot directly achieve with an ISO? (Well, you could of course rollback the snapshot and then boot, but that's more time consuming and less flexible.)
— Kerberizer • T/C 10:54, 5 October 2021 (UTC)- Kerberizer first thing is you don't need to have a separete boot medium. I guess for the ISO you have to use a CD or USB Stick. Also last time I had problems, I had to download the Arch ISO, set up network and build the ZFS modules in the live system until I could import my pool. With e pre-build ISO this might not be so hard. However, the ZFS boot menu is always there (similar to grub) and despite a complete shell with zfs/zpool commands it has a nice overview of snapshots. You could also have multiple boot environments on different zfs filesystems on the same pool. So you could boot either arch or debian or whatever. I don't think it is an alternative to a rescue ISO but an alternative to grub. If your system is EFI capable (which it should be) you can just try it out by dropping the EFI file to any FAT32 formatted partition and select it in the boot-efi-file menu or launch it via efi shell. And last but not least: In the live ISO you can mount/import your ZFS. In ZFS-Boot menu you can boot it (it uses kexec to boot another kernel from a running linux kernel)
Thomas.oster (talk) 19:43, 5 October 2021 (UTC)- Kerberizer and Thomas.oster FYI I've just added two zfsbootmenu packages to AUR and added instructions to the manual, one package includes the tools to generate a zbm image and the other one installs the prebuilt EFI binaries. Following your discussion I decided to add some logic to the efi binaries package so that it detects the ESP partition and installs the efi binaries there. Gardar (talk) 17:42, 4 August 2022 (UTC)
- Kerberizer first thing is you don't need to have a separete boot medium. I guess for the ISO you have to use a CD or USB Stick. Also last time I had problems, I had to download the Arch ISO, set up network and build the ZFS modules in the live system until I could import my pool. With e pre-build ISO this might not be so hard. However, the ZFS boot menu is always there (similar to grub) and despite a complete shell with zfs/zpool commands it has a nice overview of snapshots. You could also have multiple boot environments on different zfs filesystems on the same pool. So you could boot either arch or debian or whatever. I don't think it is an alternative to a rescue ISO but an alternative to grub. If your system is EFI capable (which it should be) you can just try it out by dropping the EFI file to any FAT32 formatted partition and select it in the boot-efi-file menu or launch it via efi shell. And last but not least: In the live ISO you can mount/import your ZFS. In ZFS-Boot menu you can boot it (it uses kexec to boot another kernel from a running linux kernel)
- Thomas, ah, it's obvious how I still lack experience with UEFI and forget that it's much easier to boot different things—from UEFI itself, from an EFI shell, etc. :D One maybe stupid question comes to mind: how much additional value has ZBM over a live ISO with ZFS? I suppose booting from a snapshot is certainly one thing that you cannot directly achieve with an ISO? (Well, you could of course rollback the snapshot and then boot, but that's more time consuming and less flexible.)
- i wanted to add zfsbootmenu too. i see its inclusion has been stalled for years at this point. would it now be possible to add this? Supernova (talk) 07:12, 15 August 2025 (UTC)
Note that the AUR packages are different from the archzfs repo's
When going through these instructions, I used the AUR package instead of the archzfs repo. Which led to the inability to boot into my encrypted root. I found out in the end that this was due to a difference between the AUR package and the archzfs repo package's initcpio hooks. This should be noted.
See the difference in zfs-utils here: AUR vs. archzfs
—This unsigned comment is by Dongcarl (talk) 2022-09-08T01:50:28. Please sign your posts with ~~~~!
- Can you specifically say what's different and why it didn't work? I also used the AUR package `zfs-dkms`, and I added a note that you need to add 'zfs' to MODULES. Is that true in general, or just for AUR versions? Za3k (talk) 21:14, 2 August 2023 (UTC)
Make dataset scheme one simple minimal path
Right now there are about 3 sets of advice for how to create datasets and mount your root. (Legacy mount, automount, etc). Let's reduce it to just the first one presented, and add the rest as options at the end. The datasets explanations get confusing. Za3k (talk) 21:17, 2 August 2023 (UTC)
RAID configuration for root?
To enable less downtime in case of a disk failure, a RAIDZ configuration might be desirable for the root and other FSes needed for operation. Perhaps the example should include a raidz ocnfiguration? Wild Penguin (talk) 19:35, 9 November 2023 (UTC)
About Troubleshooting:
- I was able to boot but the system was readonly, but the system still managed to boot. I believe this may be still the same problem as the section 9.1.. The section is not clear on whether one should remove spl.spl_hostid, if it was set?
- Also, it seems like zgenhostid $(hostid) generates only one digit. I believe this might not be correct? Wild Penguin (talk) 20:35, 9 November 2023 (UTC)
- My first problem was really stupid - I forgot to add rw to Kernel parameters :--DD. I will add a small friendly notice later to the article just for user friendliness.
- As for the hostid file, I misinterpreted. It contains a binary number of the hostid. So it is not user readable by cat. Sorry for the noise! Wild Penguin (talk) 14:39, 10 November 2023 (UTC)
Why these fs options when creating the pool?
I believe a few clarifications could be useful. First, when creating the pool, why so many -O zfsprops are given, why defaults are not desireable and if/when would a user wish to change these? Looking at zfsprops man page, it is not at all clear. From later on, it seems there is a good reason to set posixacl (along with xattr=sa), but what about relatime, dnodesize, normalization=formD? Optimally, a link to some reference would be welcome instead of explaining in the page. Wild Penguin (talk) 21:58, 7 December 2023 (UTC)
Why so many datasets on the root partition?
Another thing causing confusion for a newbie to zfs is, why do we need so many datasets? On a "regular" filesystem, one would usually not create partitions or separate mounts. What are the downsides of skipping their creation? Optimally, a link to some reference would be welcome instead of explaining in the page. Wild Penguin (talk) 21:58, 7 December 2023 (UTC)
Rewrite
I'm planning to do a rewrite Poscat (talk) 10:42, 18 December 2024 (UTC)
- Why did you rewrite the guide entirely? Why didn't you put the parts back on the various bootloaders?
- Why do you forgive all users to do an LTS installation?
- I believe that if a user chooses the Kernel Mainline and zfs-dkms, or linux-lts but always with zfs-dkms through the ZFS-LINUX-LTS module will not be able to make a Chroot to its system.
- Zfsbootmenu was very interesting for those who choose ZFS on Root.
- In my opinion, the guide is not complete as before and moreover lacks many explanations and warnings that were before. EmanueleVR (talk) 01:35, 6 January 2025 (UTC)
Why did you rewrite the guide entirely? Why didn't you put the parts back on the various bootloaders?
- The original page covered a lot of out-of-scope stuff that would be better off left to other pages. For example creating zfs pool and datasets (which should be left to ZFS) and configuring boot loaders (which should be left to the respective page of the boot loaders). I consider boot loaders (and by extension zfsbootmenu) out of scope because they simply invoke the kernel (either the UKI image or the vmlinuz image) with the right parameters, they have not effect on the boot process once the kernel takes over. All the "magic" so to speak happens in the initrd.
Why do you forgive all users to do an LTS installation?
- I recommended the LTS kernel because it is the one that has ZFS support at all time. The stable kernel (linux) can (although rare) upgrade too fast to have a supported ZFS version.
- I consider this guide complete as it provides the necessary steps to install an Arch system on ZFS root. Poscat (talk) 11:47, 7 January 2025 (UTC)
- In agreement with @Erus Iluvatar, I created a thread on the forum to find people who use zfs on Arch Linux like me, so they can give an opinion too! EmanueleVR (talk) 22:22, 10 January 2025 (UTC)
- In my humble opinion, explaining some of the things related to ZFS is quite necessary since we can’t expect readers to be ZFS experts and the ZFS wiki page is simply too long for newcomers. Take `acltype=posix` for an example: we should at least explain why we are setting this property on the root filesystem. I know that you _should_ at least understand something to use ZFS on root but we can’t just leave most of the handy information to user-googling (especially for newcomers).
- I think that we should provide a larger variety of bootloader options for the user to choose from (or we should at least document and explain the differences regarding ZFS installations) and the argument is the same for partition / filesystem layout. The old page does seem a little redundant but we can simply cut out some of the sections that are already present in other pages and leave the rest.
- Regarding bootloaders, we still can’t assume that everyone understands how filesystems work under uefi (or bios) and we should explain at least the basics since it’s not well documented yet (afaik, pls ignore me if I’m wrong). And in my humble opinion, as this page is an installation guide, we should provide as much information as possible, so users won’t have to jump between links now and then (except for Installation Guide).
- Regarding the LTS kernel, I personally run the stable Linux kernel and build the dkms variant of zfs-git and compatibility is never an issue. I think we should leave users more options to choose from since ZFS is such a flexible filesystem.
- Btw since we don’t have a separate page for ZfsBootMenu yet and since ZBM is a useful bootloader regarding root on ZFS we might as well keep it in this page for now.
- To be honest, as the Chinese translator for this page and a root-on-ZFS user (with a dataset layout similar to the macOS root filesystem), I’m afraid that I find the old page more informative. But this is only my two cents. Playing Minecraft (talk) 07:38, 18 January 2025 (UTC)
- I think we are disagreeing on the scope of this article. My judgement is based on the style of the official
- Installation guide, which is not self contained and requires a beginner to look up and read into various linked pages. It also focuses on simplicity, compromising on the coverage of more complex setups.
- I fail to see why this should be different for a ZFS installation guide.
- As of the old guide, if by "informative" you mean "length" then sure. But as I said it also covered a lot of out of scope topic, usually by simply duplicating info that already exists on their own pages. It is also has a lot of outdated/incorrect info and is de facto unmaintained and unchecked. Poscat (talk) 14:06, 18 March 2025 (UTC)
- I do not disagree with you, but I thought that we could have done something else, ie. remove the old and outdated/unwanted bits and keep other useful information. In the new version we dont have tips like grub troubleshooting (zfs specific failures, probably not present on other pages?) and we've lost explainations for many zfs options (for example, why would you enable `-O normalization=formD` on the root pool? why would you recommend using `-O acltype=posix` (for systemd-journald)? IMHO we should atl let users know about them and users would then make their own decisions).
- for example, we could remove the partitioning section in the old guide while keeping the legacy dataset layout guide. what i mean is that we could leave more options for our readers to choose from rather than giving them a single option as the default since Arch is about diy.
- This page does not have to be self-contained but imho it could be more informative (although it doesnt have to be longer).
- best regards. goopykibbles@goopykibbles-Mac-Pro ~ % (talk) 11:21, 22 March 2025 (UTC)
- As someone who completed my first arch-on-zfs-root installation just a few days before the rewrite happened, I feel the most sad about the removal of the advanced dataset structure in "Create your datasets", as well as the removal of mentions of boot environment managers. Those aren't covered in the main ZFS article, and if you aren't aware of them before doing your installation, migrating to them or an equivalent manual setup is impossible (according to the old article). I'm really glad that I got the old, more informative version of the guide. Ypoluektovich (talk) 17:21, 15 February 2025 (UTC)
- This topic can be safely closed, the changes have been reverted as most people disagreed with them. --Erus Iluvatar (talk) 12:14, 29 August 2025 (UTC)
sd-zfs does not work with native encryption
https://github.com/archlinuxcn/repo/issues/4168#issuecomment-2616651912 darkbasic (http://www.linuxsystems.it/) (talk) 19:52, 27 January 2025 (UTC)
Rollback
Given the many negative feedbacks regarding the new version of the wiki, with gaps regarding native encryption, I am planning a rollback of the guide that will serve as the basis for rewriting with official methods and explanations of possible alternatives. EmanueleVR (talk) 21:05, 19 February 2025 (UTC)
- I'm sorry. I do not see how rolling back word by word to the old version help here, especially when nobody is maintaining the old version. Hence I have reverted the rollback. Poscat (talk) 14:11, 18 March 2025 (UTC)
- The current page listings does not create a useable environment. A rollback is needed. The updated version of the page doesn't produce a useable system and adds too much unnecessary extra repositories and is complete waste of time to follow.
- The rewrite was not necessary and the wiki page needs to be rolled back. We don't need wiki pages referring people to specialized github pages by their authors just to promote their tools. Use the tools provided by the package itself for sanity of the system. We don't need packages from archlinuxcn just for zfs to have something, we don't need users visiting offsite links to github. ReaperX7 (talk) 01:28, 25 August 2025 (UTC)
- @EmanueleVR I was still able to build a working ZFS root with the 2023-January without issue. If there's a future revision we can rollback to that contains the same information, this will simplify the user experience and even the set-up. We need full thorough explanations during the installation process, not pass offs and misleading information that is in the current page. ReaperX7 (talk) 06:31, 25 August 2025 (UTC)
- Thanks @ReaperX7, I tried to keep this page, but @Poscat wouldn't give me a reason.
- The rollback was performed by me, but @Poscat promptly restored it to its current state, justifying his change with: "dataset creation must be in the ZFS wiki, because it's part of that."
- So I agree with you, I've even informed the admins of everything.
- I would have accepted improvements to the old page, but @Poscat insisted on rewriting it because, in his opinion, it wasn't fair, and he also promoted images and packages that were not "official" compared to those from the OpenZFS and archzfs teams.
- I find this behavior unacceptable, he somehow censored me, and I can't take the responsibility of an administrator by forcing a rewrite/rollback. (As he did!)
- So I also invite you to report this to @Erus Iluvatar.
- P.S.
- Their package doesn't add, but rather removes, for example, native encryption, which zfs-dkms and other official packages support.
- So if we get the green light to restore it, I'll be the first to take care of it, but working for free to make it last 30 minutes, because someone else isn't happy with it and wants to sponsor their project, no way! EmanueleVR (talk) 21:31, 25 August 2025 (UTC)
- @EmanueleVR I already restored it. We don't need questionable source packages, misleading information, and improper methods that lack clear guidance in a How-to Wiki page.
- Poscat's entries are more suited for the ZFS page itself where examples are usually fine to do, but this is a How-to guide page, not a package example and usage page. Big difference. We need clear information, not vague examples.
- Page is restored and going forward, we can use this template. If we need to contact @Erus Iluvatar then we will if the wiki page is defaced again. ReaperX7 (talk) 02:46, 26 August 2025 (UTC)
- Thanks both of you for working on this :)
- I don't use ZFS nor know anything about it so I did not intervene last time when there were only two people disagreeing on its state.
- If I may still ask more, can you two proof-read the changes from the same author in Special:Diff/820288/824201? Erus Iluvatar (talk) 08:00, 26 August 2025 (UTC)
- @Erus Iluvatar this way need reverting as well due to the fact that once again, the author is redirecting to personal projects outside the scope of archzfs and ArchLinux.
- I can handle a revert if needed but the page will need a more knowledgeable maintainer. ReaperX7 (talk) 08:45, 26 August 2025 (UTC)
- Thanks a bunch for all the work on this, closing :) --Erus Iluvatar (talk) 12:14, 29 August 2025 (UTC)
- No problem. ReaperX7 (talk) 12:45, 29 August 2025 (UTC)
- Thanks a bunch for all the work on this, closing :) --Erus Iluvatar (talk) 12:14, 29 August 2025 (UTC)
Rollback 2
Too much out-of-package stuff has been added and excluded which has made proper usage of zfs-root impossible. This revert removed self-promoted projects and non-sensible additions that were unnecessary to the general user at large.
sd-zfs is not needed and zfs-utils already has systemd relevant parts to make the package work properly.
Proper diagrams of setup, creation of datasets, mounting, dismounting, and zpool information were removed without need. This hurts the beginner user who is looking for accurate information, not misleading information leaving them circling the wiki several times to find an answer to a problem, which is how to setup zfs on root for ArchLinux. Even the section to properly set up the zpool.cache was gone in favor of some personal project which was needless.
If necessary, I will maintain this page as needed since it's been half a year since anyone bothered to do anything with it, but it will be maintained in a way that is sensible and sane, as well as minimal to additional packages, which shouldn't be required to do one simple task.... create a ZFS root to install ArchLinux on the right and proper way. ReaperX7 (talk) 17:37, 25 August 2025 (UTC)
description of different boot loader methods
currently there are multiple different boot loader methods but without explanation. would it make sense to add them e.g. zfsbootmenu offering full system encryption (even /boot/), booting into separate systems per datasets, easy snapshot management outside of the system, etc. Supernova (talk) 18:02, 25 August 2025 (UTC)
- I have a plan to simplify this to use Grub, rEFInd, and systemd-boot only while maintaining zfs encryption from the boot phase, which is supported by Grub from a separate boot partition. REFInd and systemd-boot should support it as well. ReaperX7 (talk) 02:17, 26 August 2025 (UTC)
Going forward...
My plan to simplify this page are going to be a few set of goals for the eventual next revision...
- [COMPLETED] Remove all instances of sd-zfs (yes a few pieces still linger and need removal). This is out of tree of ArchZFS and ArchLinux itself, and doesn't support encryption. This is more of a waste of time for the user since zfs-utils and the zpool creation list both methods for creating with and without encryption.
- [COMPLETED] Simplify the bootloader section to use Grub, rEFInd, and systemd-boot (possibly other supported bootloaders, but we'll cross that bridge when we come to it).
- [COMPLETED] Incorporate a proper first section for keeping to the CDDL and GPL licenses by removing the portions for premade iso images and reinstituting how the user can create their own, and the proper steps to do so. I know these are beneficial on some level, but the CDDL and GPL licenses are very clear on this, and the wiki should honour that also.
- [COMPLETED] Fix the portion of the packages needed for ZFS to include the libunwind dependency needed for zfs-utils. Unfortunately the packages themselves forgot to add this and it was theough a self-mistake that I found this package was required.
- [COMPLETED] Remove or replace some of the examples that are currently listed as questionable or unnecessary. A few entries need some minor housekeeping.
After this, the wiki page will go into maintenance mode as needed. Updates can be made but this page will be monitored for unnecessary rollbacks or revisions to versions that have too little information for the user to go from or cites packages irrelevant to archzfs and ArchLinux itself. This guide is supposed to be clear and concise, not opaque and confusing. ReaperX7 (talk) 02:35, 26 August 2025 (UTC)
- Perfect, I will definitely contribute again if the goal is to make the page accessible through official channels and not sponsorships. EmanueleVR (talk) 09:19, 26 August 2025 (UTC)
- The goal will be to maintain an accurate to form How-To guide engineered for the average user or beginner with detailed proper information relevant to the required packages, not pet projects that leave everything vague and misleading. ReaperX7 (talk) 10:20, 26 August 2025 (UTC)
- The last entry for sd-zfs is removed due to the AUR page no longer existing.
- Using systemd in the initrd is not recommended by the ArchLinux developers anyway, and the lack of support for encryption make it questionable, so it's gone. Seemingly udev usage in the initrd is the only official supported HOOK, so only officially supported things will remain. ReaperX7 (talk) 16:41, 26 August 2025 (UTC)
- Bootloader and partition creation information is updated and minimized somewhat to more standard approaches to minimize confusion and bad tactics.
- Unfortunately, syslinux was axed due to the fact that I can not ever get it working, and need someone to test the methodology. If someone can test it, even in VM, please restore that section with all relevant information, please. ReaperX7 (talk) 17:03, 27 August 2025 (UTC)
Everything is fixed
It took some time, but everything is fixed for the most part. If anyone wants to tackle syslinux for a bootloader, please feel free. Otherwise, all the relevant information is as it should be and easy enough for anyone to follow from Point A to Point Z and all points in-between in sequence. I tested this and it does produce a working system, a working ISO, and it will work for the foreseeable future. ReaperX7 (talk) 21:30, 28 August 2025 (UTC)
- I cleaned up everything finally. Everything to get a bootable system in working order has finally been accomplished. I had to refer to several videos, documentation, and the previous wiki versions to get everything back, but a dry run today on qemu ended with a "Welcome to Arch Linux" booted system.
- DO NOT TOUCH THIS PAGE AGAIN!!!
- Unless you're adding information to syslinux, rEFInd, and systemd-boot entries, DO NOT TOUCH ANYTHING!
- It took me about a week to get this page back to usefulness. Let's try to keep it working. ReaperX7 (talk) 03:54, 31 August 2025 (UTC)
- Thanks for editing the page. However:
- DO NOT TOUCH THIS PAGE AGAIN!!!
- is not how wikis work. No one has any exclusive right on modifying page contents. What I suggest instead if you're familiar with a topic is to keep it on your watchlist. See ArchWiki:Contributing#The_most_important_task. -- Alad (talk) 08:54, 31 August 2025 (UTC)
- Thanks for editing the page. However:
- Not touching things goes back to a famous line that says "If it ain't broke, don't fix it".
- I mean it in the terms of this, to say unless absolutely necessary, just leave things alone, and it's best that way if nothing in the information is invalidated in any way. I want people to add to it, because honestly, there's stuff I probably left out and missed, but what we don't need is out of scope stuff breaking things needlessly.
- We need someone to add rEFInd boot table entries, systemd-boot boot table entries, and syslinux boot table entries.
- Add those... but please don't break the system to fix a non-problem. The system works. ReaperX7 (talk) 16:44, 31 August 2025 (UTC)