[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/l4zy/archinstall/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","l4zy","reponame","archinstall","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2021-04-24T00:37:42.823105Z","description","","is_private","last_updated","2021-04-24T04:26:07.533313Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[52],"application/vnd.docker.container.image.v1+json","name","pull_count",938,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","\n $\"drawing\"$ \n\n# Arch Installer\n\n\nJust another guided/automated [Arch Linux](https://wiki.archlinux.org/index.php/Arch_Linux) installer with a twist.\nThe 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)*.\n\n * archinstall [discord](https://discord.gg/cqXU88y) server\n * archinstall [matrix.org](https://app.element.io/#/room/#archinstall:matrix.org) channel\n * archinstall [#archinstall@freenode (IRC)](irc://#archinstall@FreeNode)\n * archinstall [documentation](https://python-archinstall.readthedocs.io/en/latest/index.html)\n\n\n# Installation & Usage\n\n $ sudo pacman -S archinstall\n\nOr simply `git clone` the repo as it has no external dependencies *(but there are optional ones)*.
\nOr use `pip install --upgrade archinstall` to use as a library.\n\n## Running the [guided](examples/guided.py) installer\n\nAssuming you are on a Arch Linux live-ISO and booted into EFI mode.\n\n # python -m archinstall guided\n\n# Mission Statement\n\nArchinstall promises to ship a [guided installer](https://github.com/archlinux/archinstall/blob/master/examples/guided.py) that follows the [Arch Principles](https://wiki.archlinux.org/index.php/Arch_Linux#Principles) as well as a library to manage services, packages and other Arch Linux aspects.\n\nThe 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.\n\n---\n\nArchinstall 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.\n\nTherefore, Archinstall will try its best to not introduce any breaking changes except for major releases which may break backwards compability after notifying about such changes.\n\n# Scripting your own installation\n\nYou could just copy [guided.py](examples/guided.py) as a starting point.\n\nBut assuming you're building your own ISO and want to create an automated install process, or you want to install virtual machines on to local disk images.
\nThis is probably what you'll need, a [minimal example](examples/minimal.py) of how to install using archinstall as a Python library.\n\n```python\nimport archinstall, getpass\n\n# Select a harddrive and a disk password\nharddrive = archinstall.select_disk(archinstall.all_disks())\ndisk_password = getpass.getpass(prompt='Disk password (won\\'t echo): ')\n\n# We disable safety precautions in the library that protects the partitions\nharddrive.keep_partitions = False\n\n# First, we configure the basic filesystem layout\nwith archinstall.Filesystem(harddrive, archinstall.GPT) as fs:\n # We create a filesystem layout that will use the entire drive\n # (this is a helper function, you can partition manually as well)\n fs.use_entire_disk(root_filesystem_type='btrfs')\n\n boot = fs.find_partition('/boot')\n root = fs.find_partition('/')\n\n boot.format('vfat')\n\n # Set the flag for encrypted to allow for encryption and then encrypt\n root.encrypted = True\n root.encrypt(password=disk_password)\n\nwith archinstall.luks2(root, 'luksloop', disk_password) as unlocked_root:\n unlocked_root.format(root.filesystem)\n unlocked_root.mount('/mnt')\n\n boot.mount('/mnt/boot')\n\nwith archinstall.Installer('/mnt') as installation:\n if installation.minimal_installation():\n installation.set_hostname('minimal-arch')\n installation.add_bootloader()\n\n installation.add_additional_packages(['nano', 'wget', 'git'])\n\n # Optionally, install a profile of choice.\n # In this case, we install a minimal profile that is empty\n installation.install_profile('minimal')\n\n installation.user_create('devel', 'devel')\n installation.user_set_pw('root', 'airoot')\n \n```\n\nThis installer will perform the following:\n\n * Prompt the user to select a disk and disk-password\n * Proceed to wipe the selected disk with a `GPT` partition table.\n * Sets up a default 100% used disk with encryption.\n * Installs a basic instance of Arch Linux *(base base-devel linux linux-firmware btrfs-progs efibootmgr)*\n * Installs and configures a bootloader to partition 0.\n * Install additional packages *(nano, wget, git)*\n * Installs a profile with a window manager called [awesome](https://github.com/archlinux/archinstall/blob/master/profiles/awesome.py) *(more on profile installations in the [documentation](https://python-archinstall.readthedocs.io/en/latest/archinstall/Profile.html))*.\n\n> **Creating your own ISO with this script on it:** Follow [ArchISO](https://wiki.archlinux.org/index.php/archiso)'s guide on how to create your own ISO or use a pre-built [guided ISO](https://hvornum.se/archiso/) to skip the python installation step, or to create auto-installing ISO templates. Further down are examples and cheat sheets on how to create different live ISO's.\n\n## Unattended installation based on MAC address\n\nArchinstall comes with a [unattended](examples/unattended.py) 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 that [unattended](examples/unattended.py) is run on has the MAC address `52:54:00:12:34:56` it will look for a profile called [profiles/52-54-00-12-34-56.py](profiles/52-54-00-12-34-56.py). If it's found, the unattended installation will commence and source that profile as it's installation proceedure.\n\n# Help\n\nSubmit an issue on Github, or submit a post in the discord help channel.
\nWhen doing so, attach any `install-session_*.log` to the issue ticket which can be found under `~/.cache/archinstall/`.\n\n# Testing\n\n## Using a Live ISO Image\n\nIf 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.\n\n 1. You need a working network connection\n 2. Install the build requirements with `pacman -Sy; pacman -S git python-pip`\n *(note that this may or may not work depending on your RAM and current state of the squashfs maximum filesystem free space)*\n 3. Uninstall the previous version of archinstall with `pip uninstall archinstall`\n 4. Now clone the latest repository with `git clone https://github.com/archlinux/archinstall`\n 5. Enter the repository with `cd archinstall`\n *At this stage, you can choose to check out a feature branch for instance with `git checkout torxed-v2.2.0`*\n 6. Build the project and install it using `python setup.py install`\n\nAfter this, running archinstall with `python -m archinstall` will run against whatever branch you chose in step 5.\n\n## Without a Live ISO Image\n\nTo test this without a live ISO, the simplest approach is to use a local image and create a loop device.
\nThis can be done by installing `pacman -S arch-install-scripts util-linux` locally and doing the following:\n\n # dd if=/dev/zero of=./testimage.img bs=1G count=5\n # losetup -fP ./testimage.img\n # losetup -a | grep \"testimage.img\" | awk -F \":\" '{print $1}'\n # pip install --upgrade archinstall\n # python -m archinstall guided\n # 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\n\nThis will create a *5GB* `testimage.img` and create a loop device which we can use to format and install to.
\n`archinstall` is installed and executed in [guided mode](#docs-todo). Once the installation is complete,
\n~~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 gives you a general idea of what we're going for here)*\n\nThere's also a [Building and Testing](https://github.com/archlinux/archinstall/wiki/Building-and-Testing) guide.
\nIt will go through everything from packaging, building and running *(with qemu)* the installer against a dev branch.\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",736606226,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},"content_type","creator",5879381,"full_size",329551953,"id",146942372,"images",[97],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},"architecture","amd64","digest","sha256:e108d052cfd3834ee01d5294e97ac259bce5e3e7617466c548ab2ce9cdcbec1b","features","last_pulled","2026-09-23T17:23:20.665664926Z","last_pushed","2021-04-24T04:26:08Z","os","linux","os_features","os_version","size","variant","2021-04-24T04:26:07.22109Z","last_updater","last_updater_username","media_type","latest","repository",12640723,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":138,"_53":31,"_28":29,"_54":55,"_56":40,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":139,"_75":11,"_76":141,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":140},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_144":60,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":150,"_46":113,"_114":90,"_115":29,"_116":52,"_53":117,"_118":119,"_120":104,"_121":113,"_122":62,"_123":17},[151],{"_98":99,"_100":101,"_102":44,"_103":104,"_105":106,"_107":108,"_109":44,"_110":-5,"_111":92,"_59":62,"_112":-5},[],"canDeleteTags","actionData","errors"]

l4zy/archinstall

Tags for l4zy/archinstall