install.conf reference

Every setting install.conf accepts, alphabetically. The shipped file itself documents each of these inline with more context; this is the flat list for when you already know roughly what you want and just need the exact name and default.

Disk and filesystems

A_DISKwhole disk to partition automatically; unset by default
A_ROOT_PARTexisting root partition instead of A_DISK
A_BOOT_PARTexisting boot/ESP partition
A_HOME_PARTexisting separate /home partition
A_FORMATno — format existing partitions before use
A_ROOT_FSext4 — ext4, ext3, ext2, btrfs, xfs, f2fs, zfs
A_BOOT_FSvfat
A_BTRFS_OPTSmount options for every btrfs subvolume
A_BTRFS_SUBVOLS@ @home @snapshots @log
A_SNAPSHOTnonebtrfs to snapshot before every package change
A_MOUNTSextra fstab lines beyond root/boot/home, one per line
A_DISK_RESERVEspace to leave unpartitioned at the end of a whole-disk install

Encryption and swap

A_ENCRYPTno — LUKS2 under the chosen filesystem
A_ENCRYPT_PASSrequired if A_ENCRYPT=yes
A_SWAPnone — none, file, partition
A_SWAPSIZE4G — size of a swapfile
A_SWAPDEVpartition, if A_SWAP=partition
A_ZRAMno — compressed swap in RAM, composes with A_SWAP
A_ZRAM_SIZE50%
A_ZRAM_ALGOzstd

Boot

A_BOOT_FWunset — detected automatically (efi or bios)
A_BOOTLOADERlimine — or grub
A_BOOT_MOUNT/boot/efi
A_BOOT_TIMEOUT3 seconds
A_KERNEL_ARGSextra kernel command line, appended to every entry
A_GENERATIONS5 — how many appear in the boot menu; 0 disables the entries
A_KERNELArctic-base-kernel — see kernels
A_MICROCODEauto — auto, intel, amd, none

Init

A_INITbusybox — see init systems for the full list and honest status of each

System identity

A_HOSTNAMEarctic
A_TZUTC
A_LOCALEen_US.UTF-8
A_LANGen_US.UTF-8
A_KEYMAPus
A_CONSOLE_FONTunset — a specific console font, if wanted
A_NTPyes — sync the clock at boot
A_TRIMauto — periodic TRIM; auto enables it only on non-rotational disks

Accounts

A_USERunset — no account created, log in as root
A_USERPASSpassword for A_USER
A_ROOTPASSunset — root stays locked
A_SHELL/bin/zsh
A_USER_GROUPSwheel users audio video input
A_DOAS_NOPASSno — let wheel use doas without a password prompt each time
A_LOCK_ROOTno — lock root outright once A_USER exists

Networking

A_NEToffline — offline, dhcp, wifi, static
A_WIFI_SSID, A_WIFI_PSK, A_WIFI_IFACEsee networking
A_IP, A_GATEWAY, A_DNSfor A_NET=static
A_SSHno
A_SSH_PASSWORD_AUTHyes
A_SSH_KEYSpublic keys to seed into authorized_keys
A_FIREWALLyes — nftables, default-deny inbound
A_MAC_RANDOMIZEno

Desktop and audio

A_DESKTOPnone — see desktops and audio
A_DMunset — follows the desktop's own default
A_GPUauto
A_AUDIOno
A_BLUETOOTHno

Packages and hardening

A_PKGSextra alpm package names, space separated
A_FONTSextra fonts, space separated
A_SERVICESextra services to enable, beyond what other settings imply
A_SETSpackage category shortcuts — devel, net, media, office, virt, gaming, cli
A_PKGITno — install pkgit alongside alpm
A_HARDEN_TMPno — mount /tmp nosuid,nodev,noexec

Post-install

A_POSTshell commands run inside the new system once everything else finishes
A_CHROOT_SHELLno — drop to a shell in the new system before unmounting
A_REBOOTno — reboot automatically once the install finishes

More: arctic linux docs · install · declarative configuration · generations and rollback · init systems · kernels · packages (alpm) · desktops and audio · networking · ephemeral shells · musl · building from source · troubleshooting