History

Manuel Thalmann 18724d57b6 Update the `archiso` template		2024-10-31 15:29:58 +01:00
..
airootfs	Update the `archiso` template	2024-10-31 15:29:58 +01:00
efiboot/loader	Add the default `archiso` `releng` template	2024-06-18 21:13:47 +02:00
grub	Add the default `archiso` `releng` template	2024-06-18 21:13:47 +02:00
scripts	Update the `archiso` template	2024-10-31 15:29:58 +01:00
syslinux	Add the default `archiso` `releng` template	2024-06-18 21:13:47 +02:00
.gitignore	Ignore the default work directory	2024-06-20 15:55:36 +02:00
bootstrap_packages.x86_64	Add the default `archiso` `releng` template	2024-06-18 21:13:47 +02:00
packages.x86_64	Update the `archiso` template	2024-10-31 15:29:58 +01:00
pacman.conf	Update the `archiso` template	2024-10-01 15:32:56 +02:00
profiledef.sh	Add the default `archiso` `releng` template	2024-06-18 21:13:47 +02:00
README.md	Add further explanation to the `archiso` project	2024-09-30 15:21:09 +02:00

README.md

archiso-valhalla

Creates .iso files or PXE boot assets for setting up Arch Linux.

.iso files created using this project will contain a copy of this repository including the current uncommitted or untracked changes.

When booting the resulting .iso file, the Arch Linux setup will automatically start using the scripts/Arch/OS/setup.fish script in this repository.

Usage

This project is meant to be used on Arch Linux. However, configuration files are provided to use it on any Linux system (or WSL) with Nix installed.

Requirements

Arch Linux

If you are using Arch Linux, make sure that the archiso package is installed on your system:

sudo pacman -Syu archiso

Nix

On any other Linux system with Nix installed, use nix to automatically set up a development shell with the necessary tools installed:

nix develop

Creating a `.iso`

To create a .iso file for installing Arch Linux, run the following command:

./scripts/build.fish

The script accepts all additional arguments which are accepted by the mkarchiso command.

Running this script will generate a .iso file in a new folder called out. This .iso file can be used for installing Arch Linux.

Updating

This project also contains scripts for updating the files in case Arch Linux's releng template (the archiso template used by this project) changed. Said scripts are described briefly in the following chapters.

Show Diff

Show the differences between this archiso configuration and Arch Linux's releng template by running the following command:

./scripts/show-diff.fish

Update the Patch

To update the patch containing the differences between Arch Linux's releng template and this archiso configuration, run this command:

./scripts/update-patch.fish

Update the Project

In case Arch Linux did major changes to the releng template, it might make sense to replicate these in this archiso configuration. The following command will try to do so using the patch located at ./scripts/valhalla.patch:

./scripts/update.fish

Booting the `.iso` File

The .iso file can be booted like any other .iso file (by writing it on a USB stick, burning it on a DVD or attaching it to a VM).

Most notably, .iso files created using this project will also work with USB thumbsticks with Ventoy installed.