From d0d8b670bc45f526766b158215f57060e53a412b Mon Sep 17 00:00:00 2001 From: Daniel Girtler Date: Mon, 19 Jan 2026 08:28:14 +1100 Subject: [PATCH 1/5] Clarify upgrade steps on Live ISO --- README.md | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 287f215a1b..e87bb3eecc 100644 --- a/README.md +++ b/README.md @@ -18,13 +18,23 @@ The installer also doubles as a python library to install Arch Linux and manage > In the ISO you are root by default. Use sudo if running from an existing system. ```shell - # pacman-key --init - # pacman -Sy archinstall - # archinstall +pacman-key --init +pacman -Sy archinstall +archinstall ``` Alternative ways to install are `git clone` the repository (and is better since you get the latest code regardless of [build date](https://archlinux.org/packages/?sort=&q=archinstall)) or `pip install --upgrade archinstall`. +### Upgrade `archinstall on live Arch ISO image + +Upgrading archinstall on the ISO needs to be donw via a full system upgrade using `pacman -Syu` + +When booting from a live USB, the space on the ramdisk is limited and may not be sufficient to allow running a re-installation or upgrade of the installer. +In case one runs into this issue, any of the following can be used + +* Resize the root partition https://wiki.archlinux.org/title/Archiso#Adjusting_the_size_of_the_root_file_system +* Specify the boot parameter copytoram=y (https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio-archiso/-/blob/master/docs/README.bootparams#L26) which will copy the root filesystem to tmpfs + ## Running the [guided](https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py) installer Assuming you are on an Arch Linux live-ISO or installed via `pip`: @@ -139,12 +149,6 @@ The profiles' definitions and the packages they will install can be directly vie If you want to test a commit, branch, or bleeding edge release from the repository using the standard Arch Linux Live ISO image, replace the archinstall version with a newer one and execute the subsequent steps defined below. -*Note: When booting from a live USB, the space on the ramdisk is limited and may not be sufficient to allow -running a re-installation or upgrade of the installer. In case one runs into this issue, any of the following can be used -- Resize the root partition https://wiki.archlinux.org/title/Archiso#Adjusting_the_size_of_the_root_file_system -- The boot parameter `copytoram=y` (https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio-archiso/-/blob/master/docs/README.bootparams#L26) -can be specified which will copy the root filesystem to tmpfs.* - 1. You need a working network connection 2. Install the build requirements with `pacman -Sy; pacman -S git python-pip gcc pkgconf` *(note that this may or may not work depending on your RAM and current state of the squashfs maximum filesystem free space)* From e9840350ff79cc5ef67c4a7ad443e4f4f2c76a0a Mon Sep 17 00:00:00 2001 From: Daniel Girtler Date: Mon, 19 Jan 2026 08:30:22 +1100 Subject: [PATCH 2/5] Update --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e87bb3eecc..7350ec0e23 100644 --- a/README.md +++ b/README.md @@ -25,7 +25,7 @@ archinstall Alternative ways to install are `git clone` the repository (and is better since you get the latest code regardless of [build date](https://archlinux.org/packages/?sort=&q=archinstall)) or `pip install --upgrade archinstall`. -### Upgrade `archinstall on live Arch ISO image +## Upgrade `archinstall` on live Arch ISO image Upgrading archinstall on the ISO needs to be donw via a full system upgrade using `pacman -Syu` From 9e3318ad846130d4cef734f8543f794f60a41d52 Mon Sep 17 00:00:00 2001 From: Daniel Girtler Date: Mon, 19 Jan 2026 08:34:38 +1100 Subject: [PATCH 3/5] Update --- README.md | 20 +++++++++++++------- 1 file changed, 13 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index 7350ec0e23..d91a398166 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,8 @@ Alternative ways to install are `git clone` the repository (and is better since ## Upgrade `archinstall` on live Arch ISO image -Upgrading archinstall on the ISO needs to be donw via a full system upgrade using `pacman -Syu` +Upgrading archinstall on the ISO needs to be donw via a full system upgrade using +```pacman -Syu``` When booting from a live USB, the space on the ramdisk is limited and may not be sufficient to allow running a re-installation or upgrade of the installer. In case one runs into this issue, any of the following can be used @@ -37,17 +38,22 @@ In case one runs into this issue, any of the following can be used ## Running the [guided](https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py) installer -Assuming you are on an Arch Linux live-ISO or installed via `pip`: +Assuming you are on an Arch Linux live-ISO or installed via `pip`, `archinstall` will use the `guided` script by default ```shell archinstall ``` - -## Running the [guided](https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py) installer using `git` +similar goes for running the [guided](https://github.com/archlinux/archinstall/blob/master/archinstall/scripts/guided.py) installer using `git ```shell - # git clone https://github.com/archlinux/archinstall - # cd archinstall - # python -m archinstall $@ +git clone https://github.com/archlinux/archinstall +cd archinstall +python -m archinstall $@ +``` + +To run alternative scripts using the `--script` parameter + +``` +archinstall --script ``` #### Advanced From 571620734e079207fd29f4e8151f5d561dfd5b5f Mon Sep 17 00:00:00 2001 From: Daniel Girtler Date: Mon, 19 Jan 2026 08:35:24 +1100 Subject: [PATCH 4/5] Update --- README.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index d91a398166..e4b6b7a474 100644 --- a/README.md +++ b/README.md @@ -28,7 +28,10 @@ Alternative ways to install are `git clone` the repository (and is better since ## Upgrade `archinstall` on live Arch ISO image Upgrading archinstall on the ISO needs to be donw via a full system upgrade using -```pacman -Syu``` + +```shell +pacman -Syu +``` When booting from a live USB, the space on the ramdisk is limited and may not be sufficient to allow running a re-installation or upgrade of the installer. In case one runs into this issue, any of the following can be used From aa0426168cc794432f3224b282602bcc0f5d28f0 Mon Sep 17 00:00:00 2001 From: Anton Hvornum Date: Mon, 26 Jan 2026 23:30:16 +0100 Subject: [PATCH 5/5] Update README.md Spelling fix --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index e4b6b7a474..1447c26397 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ Alternative ways to install are `git clone` the repository (and is better since ## Upgrade `archinstall` on live Arch ISO image -Upgrading archinstall on the ISO needs to be donw via a full system upgrade using +Upgrading archinstall on the ISO needs to be done via a full system upgrade using ```shell pacman -Syu