Add an explanation to the archiso project

This commit is contained in:
Manuel Thalmann 2024-06-20 15:50:20 +02:00
parent 1e1cfabf16
commit d6f1109588
2 changed files with 39 additions and 3 deletions

View file

@ -1,5 +1,9 @@
# PortValhalla
Provides both scripts and descriptive texts explaining how to set up my personal experience on my private devices
Provides both scripts and descriptive texts explaining how to set up my personal experience on my private devices.
So far, scripts and explanations for the following devices have been added:
- [My Surface Book 2](./devices/ManuSurface/ManuSurfaceSetup.md)
## Components
This project is split into multiple separate projects for different purposes.
Head over to the individual projects to find out more about them:
- [`archiso`](./archiso):
Provides scripts for creating a hand tailored `.iso` for setting up Arch Linux on a machine

32
archiso/README.md Normal file
View file

@ -0,0 +1,32 @@
# archiso-valhalla
Creates `.iso` files or PXE boot assets for setting up Arch Linux.
## 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:
```sh
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:
```sh
nix develop
```
### Creating a `.iso`
To create a `.iso` file for installing Arch Linux, run the following command:
```sh
mkarchiso .
```
This will generate a `.iso` file in a new folder called `out`. This `.iso` file can be used for installing Arch Linux.
<!--- References --->
[Nix]: https://nixos.org