Arch Linux Archiso builder with zfs support

This repository contains a simple, free as in freedom, wrapper to automate the steps mentioned in the arch linux wiki for the zfs installation and the archios package installation.

The current changelog can be found here.

All you need to do is to execute the build.sh.

You can download a build iso to use here.

All needed packages where installed automatically. The build script will output the path to the created iso file.

At the end, you only need to dd the iso to your favorit usb drive, use venotoy or burn it on an optical disk.

Live environment

This iso comes with some batteries included.

• archinstall in /root/software/archinstall including a start_archinstall.sh
• arch-linux-configuration in /root/software/arch-linux-configuration
  • This repository has a recover section to ease up fixing broken installations
• downgrade to the image in the path /root/software/downgrade
  • This repository has a downgrade executable to ease up downgrade a package
• general_howtos in /root/document/general_howtos
  • This repository has an arch linux knowledge section inside
  • This repository has a unix knowledge section inside
  • This repository has a zfs knowledge section inside
  • And much more knowledge
• Git
• Vim

Howto

Build by using docker

# run a build
docker compose run --rm archlinux-container /app/build.sh

# to debug the container
#   login and cd /app
docker compose run --rm archlinux-container bash

Build by using podman

# run a build
# we need to run podman with privilege rights
sudo podman compose run --rm archlinux-container /app/build.sh

# to debug the container
#   login and cd /app
sudo podman compose run --rm archlinux-container bash

Build by using your host

Initial setup

This must be done once.

# ref: https://github.com/archzfs/archzfs/wiki#using-the-archzfs-repository
sudo pacman-key -r 3A9917BF0DED5C13F69AC68FABEC0A1208037BE9
sudo pacman-key --lsign-key 3A9917BF0DED5C13F69AC68FABEC0A1208037BE9

List of available scripts

####
# Tired of repeating the same flags again and again?
#
# optional configuration file is supported and saves your keystrokes
# cp .env.dist.dist .env
# adapt file .env
####

####
#build an iso
####
#flags
#   -f|--force
#   -d|--dry-run
#   -h|--help
#   -r|--repo-index [<string: last|week|month|yyyy\/mm\/dd>]
#       if you just use -r, default of >>last<< is used
#       @see: https://archive.archlinux.org/repos/
#   -u|--use-dkms
#   -v|--verbose
#   -z|--zfs-servers [<string: experimental|default>]
####
./build.sh

#test run an existing iso
./run_iso.sh [<string: path to the iso>]

#upload the iso
./upload_iso.sh [<string: path to the iso>]

Run super-linter locally

# ref: https://github.com/super-linter/super-linter#run-using-a-container-runtime-engine
#   assuming that . is the path to the local code base
docker run --rm -e LOG_LEVEL=DEBUG -e RUN_LOCAL=true -v .:/tmp/lint ghcr.io/super-linter/super-linter:latest

Possible issues

Following issues are not reproducible on all my machines.

Error: target not found: ipw2100-fw

• This error happens when calling build.sh
• This commit seams to be the reason
• This thread contains information
• This is a solution for endeavour os

Links

• Another archiso build script by Maurice Zhou: gitlab.com
• archiso documentation: archlinux.org
• archiso project page: archlinux.org
• archlinux-lts-zfs build by r-maerz: github.com - 20241118
• archzfs archive containing each package ever build: archzfs.com - 20240410
• Install UEFI and BIOS compatible Arch Linx with encrypted ZFS and ZFSBootMenu by Kayvlim: archlinux.org - 20221108
• pacman wiki page: archlinux.org
• OpenSSF Scorecard Report: securityscorecards.dev - 20240408
• Ubuntu server zfsbootmenu: github.com - 20221108

Contributors

In alphabetically order.

• derzahla
  • Updated sed repro index logic
• gardar
  • Added git workflows
• Kodiman
  • Added information of the Ubuntu server zfsbootmenu
• stevleibelt
  • Main Developer