Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eoli3n/archiso-zfs
Easily load ZFS kernel module on any Archiso.
https://github.com/eoli3n/archiso-zfs
archiso archiso-image archlinux archzfs default-archiso dkms zfs zfs-kernel
Last synced: 5 days ago
JSON representation
Easily load ZFS kernel module on any Archiso.
- Host: GitHub
- URL: https://github.com/eoli3n/archiso-zfs
- Owner: eoli3n
- Created: 2020-05-01T14:02:09.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-06-08T09:27:31.000Z (5 months ago)
- Last Synced: 2024-11-07T05:38:57.488Z (7 days ago)
- Topics: archiso, archiso-image, archlinux, archzfs, default-archiso, dkms, zfs, zfs-kernel
- Language: Shell
- Homepage:
- Size: 207 KB
- Stars: 181
- Watchers: 9
- Forks: 33
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
### Why this
If you want to install Archlinux on ZFS, you need to deal with the [ZFS licensing problem](https://wiki.archlinux.org/index.php/ZFS). The kernel module isn't included in the default archiso image, you need to [include it](https://wiki.archlinux.org/index.php/ZFS#Embed_the_archzfs_packages_into_an_archiso) into a custom archiso image to be able to install ZFS.
I wrote an article about [archiso netbooting](https://eoli3n.github.io/2020/04/25/recovery.html).
This script lets you include the zfs kernel module on any archiso image without creating a custom one.
### Archzfs
The [Archzfs](https://github.com/archzfs/archzfs/wiki) unofficial user repository offers multiple ways to install the ZFS kernel module.
We can install precompiled module with ``zfs-linux`` package or compile the zfs module using [DKMS method](https://wiki.archlinux.org/index.php/ZFS#DKMS).
In order to build the module, DKMS needs the ``linux-headers`` package for the running kernel.
### How does it work
It extracts running kernel version and try to find a matching ZFS module in ``Archzfs`` repositories.
If it doesn't, it fallbacks to the DKMS build of the ZFS module.
In that case, the script uses [Arch Linux Archive](https://wiki.archlinux.org/index.php/Arch_Linux_Archive#How_to_restore_all_packages_to_a_specific_date) to install the ``linux-headers`` and ``base-devel`` packages required for DKMS. You need at least ~6Gb RAM to use that method to be able to store packages in cowspace.
In some very specific cases, you won't be able to get ZFS module working for a specific archiso version.
In that case, just switch to the previous month iso.
### How to use
Boot on any archiso system, and run:
```
$ curl -s https://raw.githubusercontent.com/eoli3n/archiso-zfs/master/init | bash
```
### Debug
By default, command outputs are redirected to /dev/null.
To run the script in verbose mode, use:
```
$ curl -s https://raw.githubusercontent.com/eoli3n/archiso-zfs/master/init | bash -s -- -v
```
Running the script produces a ``debug.log`` file in the current directory.
To upload this easily, you can
```
$ pacman -Syy pastebinit
$ pastebinit -b sprunge.us debug.log
```
And then paste me the url in your issue.
### Dev
To easily generate a VM with the latest archiso, to test the script in, on your host with qemu/libvirt and vagrant installed :
Use [https://github.com/eoli3n/arch-config/tree/master/vagrant](https://github.com/eoli3n/arch-config/tree/master/vagrant).
### Related
- [Archzfs issue : Dynamically build/load ZFS module on default archiso #337](https://github.com/archzfs/archzfs/issues/337)
- [Archlinux Wiki : Install Arch Linux On ZFS](https://wiki.archlinux.org/index.php/Install_Arch_Linux_on_ZFS#Get_ZFS_module_on_archiso_system)