Advanced - kwankiu/archlinux-installer GitHub Wiki

Usage of the create-installation-media tool

create-installation-media -OPTIONS or --OPTIONS=<arguments> ...

Options

Options Arguments Description
-h or --help N/A Usage and Infomation of this Installation Tool.
-d or --dev N/A Use latest dev version of this Installation Tool.
-i or --image <image_name> Create a disk image with the default image name (-archlinux-.<image_format>) in the out folder or specify an image name with the <image_name> argument.
--vmimages <format1,format2,...> Generate Virtual Machine images, check qemu-img for supported formats, you may specify more than one format separated by comma.
-k or --kernel <kernel_name> Create Arch Linux using the default kernel option or specify a kernel option with the <kernel_name> argument.
-m or --mtimg N/A Skip partitioning and use an image instead. (When this argument is used, --image=<image_name> will become the image to be used). Notes: This workaround allows you to put an empty partitioned image in --image and skip the formatting and partitioning process.
-b or --bootpart N/A Create Arch Linux with a seperated boot partition.
-c or --compress N/A Compress the Disk Image to .img.xz
--size <image_size> Set disk image size (default is 4G).
--disk <disk_path> Create Arch Linux on the specified disk path (or the image mount point when used with -i or --image which is /dev/loop1 by default).
--bootpartstart <size> Set Boot/Config Partition Start Sector (default is 16MiB).
--bootpartend <size> Set Boot/Config Partition End Sector (default is 32MiB for Config or 500MiB for Boot).
--addpkg <package_name> Get extra packages from repo (same as where it gets kernel packages) that is installed during first boot.
--adrepourl <url> Use a custom repo instead of the default one, it updates the variable adrepo_url.
--model <model> Set a device model to generate boot config for.
--bootfirmware <path> Flash a boot firmware to the target disk or image. The specified path must be .img file or a directory that contains idbloader.img and uboot.itb.
--bootloader <bootloader> Set which bootloader to use for config, available options are extlinux and grub (default is extlinux).
--script <path> Run an additional script in chroot.

Examples

Install on a disk

Prompt for picking installation options (The interactive menu is currently outdated, it may not work).

bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media)

OR

Install on a disk (replace /dev/nvme0n1 with yours) with the default Kernel option.

bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media) --disk=/dev/nvme0n1 -k

Create an image

Create an Arch Linux Installer image (.img) with the default Kernel option.

bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media) -i -k

OR

Create an Arch Linux Installer image (.img) with a custom image name and size using the default Kernel option.

bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media) --image=myarchinstaller.img --size=4G -k

Create an Arch Linux Installer image (.img) with the following options:

  • Model: Radxa Rock 5B (the model name can be found at the GitHub workflow's matrix)
  • Kernel: linux-aarch64-rockchip-bsp6.1-joshua-git (this package should be one of the package available on the repo defined at adrepourl)
  • Firmware Package: linux-firmware-joshua-git (this package should be one of the package available on the repo defined at adrepourl)
  • Bootloader: u-boot + extlinux (u-boot needs to be provided in an accessible folder on your local machine, in this example, it is located at $pwd/usr/lib/u-boot, u-boot can be built from source code or extracted from a u-boot (.deb) debian package if available)
bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media) --model=radxa-rock-5b -c --kernel=linux-aarch64-rockchip-bsp6.1-joshua-git --addpkg=linux-firmware-joshua-git --bootfirmware=usr/lib/u-boot

Using the dev branch version

(WARNING: the dev branch is not tested and may be broken.)

bash <(curl -fsSL https://raw.githubusercontent.com/kwankiu/archlinux-installer/main/create-installation-media) --dev

Oops! You have reached the end of this Wiki

Back to Home Page

⚠️ **GitHub.com Fallback** ⚠️