Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
Arch Linux installer — guided, templates etc.
License
archlinux/archinstall
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
Just another guided/automated Arch Linux installer with a twist. The installer also doubles as a python library to install Arch Linux and manage services, packages and other things inside the installed system (Usually from a live medium).
- archinstall discord server
- archinstall matrix.org channel
- archinstall #archinstall@irc.libera.chat
- archinstall documentation
$ sudo pacman -S archinstall Alternative ways to install are git clone the repository or pip install —upgrade archinstall .
Assuming you are on an Arch Linux live-ISO or installed via pip :
Running the guided installer using git
# cd archinstall-git # cp archinstall/scripts/guided.py # python guided.py Some additional options that are not needed by most users are hidden behind the —advanced flag.
Running from a declarative configuration file or URL
archinstall can be run with a JSON configuration file. There are 2 different configuration files to consider, the user_configuration.json contains all general installation configuration, whereas the user_credentials.json contains the sensitive user configuration such as user password, root password and encryption password.
An example of the user configuration file can be found here configuration file and example of the credentials configuration here credentials file.
HINT: The configuration files can be auto-generated by starting archinstall , configuring all desired menu points and then going to Save configuration .
To load the configuration file into archinstall run the following command
Archinstall is available in different languages which have been contributed and are maintained by the community. Current translations are listed below and vary in the amount of translations per language
English Arabic Brazilian Portuguese Czech Dutch Estonian French Georgian German Indonesian Italian Korean Modern Greek Polish Portuguese Russian Spanish Swedish Tamil Turkish Ukrainian Urdu Any contributions to the translations are more than welcome, to get started please follow the guide
Submit an issue here on GitHub, or submit a post in the discord help channel.
When doing so, attach the /var/log/archinstall/install.log to the issue ticket. This helps us help you!
Archinstall promises to ship a guided installer that follows the Arch Principles as well as a library to manage services, packages and other Arch Linux aspects.
The guided installer will provide user-friendly options along the way, but the keyword here is options, they are optional and will never be forced upon anyone. The guided installer itself is also optional to use if so desired and not forced upon anyone.
Archinstall has one fundamental function which is to be a flexible library to manage services, packages and other aspects inside the installed system. This library is in turn used by the provided guided installer but is also for anyone who wants to script their own installations.
Therefore, Archinstall will try its best to not introduce any breaking changes except for major releases which may break backwards compatibility after notifying about such changes.
Scripting your own installation
Scripting interactive installation
There are some examples in the examples/ directory that should serve as a starting point.
The following is a small example of how to script your own interative installation:
from pathlib import Path from archinstall import Installer, ProfileConfiguration, profile_handler, User from archinstall.default_profiles.minimal import MinimalProfile from archinstall.lib.disk.device_model import FilesystemType from archinstall.lib.disk.encryption_menu import DiskEncryptionMenu from archinstall.lib.disk.filesystem import FilesystemHandler from archinstall.lib.interactions.disk_conf import select_disk_config fs_type = FilesystemType('ext4') # Select a device to use for the installation disk_config = select_disk_config() # Optional: ask for disk encryption configuration data_store = <> disk_encryption = DiskEncryptionMenu(disk_config.device_modifications, data_store).run() # initiate file handler with the disk config and the optional disk encryption config fs_handler = FilesystemHandler(disk_config, disk_encryption) # perform all file operations # WARNING: this will potentially format the filesystem and delete all data fs_handler.perform_filesystem_operations() mountpoint = Path('/tmp') with Installer( mountpoint, disk_config, disk_encryption=disk_encryption, kernels=['linux'] ) as installation: installation.mount_ordered_layout() installation.minimal_installation(hostname='minimal-arch') installation.add_additional_packages(['nano', 'wget', 'git']) # Optionally, install a profile of choice. # In this case, we install a minimal profile that is empty profile_config = ProfileConfiguration(MinimalProfile()) profile_handler.install_profile_config(installation, profile_config) user = User('archinstall', 'password', True) installation.create_users(user)
This installer will perform the following:
- Prompt the user to configurate the disk partitioning
- Prompt the user to setup disk encryption
- Create a file handler instance for the configured disk and the optional disk encryption
- Perform the disk operations (WARNING: this will potentially format the disks and erase all data)
- Installs a basic instance of Arch Linux (base base-devel linux linux-firmware btrfs-progs efibootmgr)
- Installs and configures a bootloader to partition 0 on uefi. On BIOS, it sets the root to partition 0.
- Install additional packages (nano, wget, git)
- Create a new user
Creating your own ISO with this script on it: Follow ArchISO’s guide on how to create your own ISO.
Script non-interactive automated installation
For an example of a fully scripted, automated installation please see the example full_automated_installation.py
Unattended installation based on MAC address
Archinstall comes with an unattended example which will look for a matching profile for the machine it is being run on, based on any local MAC address. For instance, if the machine the code is executed on has the MAC address 52:54:00:12:34:56 it will look for a profile called 52-54-00-12-34-56.py. If it’s found, the unattended installation will commence and source that profile as its installation procedure.
archinstall ships with a set of pre-defined profiles that can be chosen during the installation process.
The definitions of the profiles and what packages they will install can be seen directly in the menu or default profiles
If you want to test a commit, branch or bleeding edge release from the repository using the vanilla Arch Live ISO image, you can replace the version of archinstall with a new version and run that with the steps described below:
- You need a working network connection
- 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)
- Uninstall the previous version of archinstall with pip uninstall archinstall
- Now clone the latest repository with git clone https://github.com/archlinux/archinstall
- Enter the repository with cd archinstall At this stage, you can choose to check out a feature branch for instance with git checkout v2.3.1-rc1
- Build the project and install it using pip install —break-operating-system .
After this, running archinstall with python -m archinstall will run against whatever branch you chose in step 5.
To test this without a live ISO, the simplest approach is to use a local image and create a loop device.
This can be done by installing pacman -S arch-install-scripts util-linux locally and doing the following:
# truncate -s 20G testimage.img # losetup -fP ./testimage.img # losetup -a | grep "testimage.img" | awk -F ":" '' # pip install --upgrade archinstall # python -m archinstall --script guided # qemu-system-x86_64 -enable-kvm -machine q35,accel=kvm -device intel-iommu -cpu host -m 4096 -boot order=d -drive file=./testimage.img,format=raw -drive if=pflash,format=raw,readonly,file=/usr/share/ovmf/x64/OVMF_CODE.fd -drive if=pflash,format=raw,readonly,file=/usr/share/ovmf/x64/OVMF_VARS.fd This will create a 20 GB testimage.img and create a loop device which we can use to format and install to.
archinstall is installed and executed in guided mode. Once the installation is complete, you can use qemu/kvm to boot the test media.
(You’d actually need to do some EFI magic in order to point the EFI vars to the partition 0 in the test medium, so this won’t work entirely out of the box, but that gives you a general idea of what we’re going for here)
There’s also a Building and Testing guide.
It will go through everything from packaging, building and running (with qemu) the installer against a dev branch.