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 enviroment

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 your host

Initial setup

This must be done once.

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

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
####
./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 -e LOG_LEVEL=DEBUG -e RUN_LOCAL=true -v .:/tmp/lint ghcr.io/super-linter/super-linter:latest

Possible issues

Following issues are not reproducable 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 contins information
• This is a solution for endevour 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

Contributers

In alphabetically order.

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