diff --git a/_nav.qd b/_nav.qd index 9b25ff3..9f3dc4d 100644 --- a/_nav.qd +++ b/_nav.qd @@ -1,2 +1,5 @@ -###! [{.icon {house}} {.projectname}](main.qd) +###! System Installation + +- [Download Arch Linux](system-installation/001-download-arch-linux.md) +- [Basic System Installation](system-installation/002-basic-system-installation.md) diff --git a/_setup.qd b/_setup.qd index 571fee8..457d683 100644 --- a/_setup.qd +++ b/_setup.qd @@ -12,7 +12,7 @@ .doctype {docs} .theme {darko} layout:{hyperlegible} -.var {assets} {assets/} +.var {assets} {@/assets} .var {logo} {{.assets}/fz-stack-icon.svg} .var {banner} {{.assets}/fz-stack-transparent.svg} .var {projectname} {fz-stack} @@ -32,8 +32,13 @@ .htmloptions title:{.pagetitle} .ifnot {.docname::equals {.pagetitle}} .htmloptions title:{.docname | .pagetitle} -.ifnot {.docname::isnone} +.if {.docname::equals {}} .docname {.pagetitle} .numbering - footnotes: i + +.function {example} + title? content: + .box {.title::otherwise {Example}} type:{tip} + .content diff --git a/assets/fz-stack-icon.svg b/public/assets/fz-stack-icon.svg similarity index 100% rename from assets/fz-stack-icon.svg rename to public/assets/fz-stack-icon.svg diff --git a/assets/fz-stack-transparent.svg b/public/assets/fz-stack-transparent.svg similarity index 100% rename from assets/fz-stack-transparent.svg rename to public/assets/fz-stack-transparent.svg diff --git a/system-installation/001-download-arch-linux.md b/system-installation/001-download-arch-linux.md new file mode 100644 index 0000000..a4359b9 --- /dev/null +++ b/system-installation/001-download-arch-linux.md @@ -0,0 +1,74 @@ +.docname {Download Arch Linux} +.include {docs} + +Download [Arch Linx][arch-linux] from one of the [official sources][arch-linux-sources]. + +> Warning: Always verify checksums. It is important to download Arch Linux from a trusted sources. +> Always check the download against signatures and checksums published on the official +> [Arch Linux][arch-linux-sources] website. Do not trust signatures published by download +> mirrors or 3rd party websites, as they could be tampered with. + +## Checksum Verification + +### Using GnuPG + +To verify the PGP signature with GnuPG, first download the release signing key from +[WKD (Web Key Discovery)][wkd] or any key service that you trust. + +```sh +gpg --auto-key-locate clear,wkd -v \ +--locate-external-key pierre@archlinux.org +``` + +Then use the obtained key to verify the signature of the downloaded file + +```sh +gpg --keyserver-options auto-key-retrieve \ +--verify archlinux-.iso.sig +``` + +### Using an existing Arch Linux System + +On a system already running Arch Linux, `pacman` can be used to verify the Installation Medium. + +```sh +pacman-key -v archlinux-.iso.sig +``` + +## Create a Bootable Medium + +Create a bottable medium from the downloaded **and verified** Arch Linux ISO. +For example, a bootable USB flash drive. + +Execute the following command to copy the downloaded ISO to the USB flash drive. + +> Important: The following command will permanently delete the data of the destination device. +> Make sure to specify the correct destination device and to back up important data prior to executing +> this command. + +```sh +dd bs=4M \ +if= \ +of=/dev/disk/by-id/usb- \ +conv=fsync oflag=direct status=progress +``` + +> Tip: After you are done using the USB flash drive for the Arch Linux installation, the following +> command must be executed to delete the ISO 9660 filesystem signature from the device to use it +> as a normal USB flash drive again. +> +> ```sh +> wipefs --all /dev/disk/by-id/usb- +> ``` + +For more details, see [Arch Linux Wiki: USB Flash Installation Medium][arch-wiki-usb-install]. + +For other methods, see [Arch Linux Wiki: Burning an Optical Disc][arch-wiki-optical-disc] or +[Arch Linux Wiki: PXE Network Boot][arch-wiki-pxe-boot]. + +[arch-linux]: https://archlinux.org/ +[arch-linux-sources]: https://archlinux.org/download/ +[arch-wiki-usb-install]: https://wiki.archlinux.org/title/USB_flash_installation_medium +[arch-wiki-optical-disc]: https://wiki.archlinux.org/title/Optical_disc_drive#Burning +[arch-wiki-pxe-boot]: https://wiki.archlinux.org/title/Preboot_Execution_Environment +[wkd]: https://keys.openpgp.org/about/usage-wkd/ diff --git a/system-installation/002-basic-system-installation.md b/system-installation/002-basic-system-installation.md new file mode 100644 index 0000000..8dd91e2 --- /dev/null +++ b/system-installation/002-basic-system-installation.md @@ -0,0 +1,71 @@ +.docname {Basic System Installation} +.include {docs} + +This page explains the basic setup of Arch Linux. It was last updated July 2026. + +> Tip: Always cross check this page with the current version of the [Arch Linux Installation Guide][arch-wiki-install], +> as the instructions on this page might be outdated or no longer complete. + +> Important: Commands in this guide will modify your hard disk, including partitions, encryption, and more. +> Make sure to understand all commands before you execute them. You will lose data! +> Consult the [Arch Wiki][arch-wiki] or the man pages of all commands and options you are unfamiliar with. +> +> Create a backup of all important data that you do not want to lose before you continue with the installation of +> Arch Linux! + +## Preparation + +To install Arch Linux, boot from the installation medium. It might be necessary to change UEFI settings to do so. +For example: + +- Disable Secure Boot +- Delete existing Boot Sequences or Boot Entries +- Enable USB Boot Support +- Enabled External USB Ports + +.box {DELL XPS 13 9370} type:{note} + In the UEFI settings: + + - Enable the support to boot from USB devices: + `System Configuration` -> `USB Configuration` -> `Enable USB Boot Support` + - Set `POST Behaviour` -> `Fastboot` to any value other than `Minimal` + + Secure Boot can already be enabled and set to audit mode to facilitate Secure Boot installation later. This allows + the machine to boot without any valid secure boot keys with a warning message. As soon as we have set up valid + keys and signed our boot image, secure boot can then be enabled to fail on unsigned boot images. + + In the UEFI settings: + + - enable `Secure Boot` -> `Secure Boot Enable` -> `Secure Boot Enable` + - set `Secure Boot` -> `Secure Boot Mode` to `Audit Mode` + - enable `Secure Boot` -> `Expert Key Management` -> `Enable Custom Mode` + + To access the boot menu or UEFI, press + + - .keybinding {F2} to access UEFI settings + - .keybinding {F12} to access one-time boot menu + +## Setting Keyboard Layout and Console Font + +List available console key maps with `localectl list-keymaps`, then set the desired key map with +`loadkeys `. + +Console fonts are located in `/usr/share/kbd/consolefonts` and can be set with `setfont `. + +.example + ```sh + loadkeys de-latin1 + setfont eurlatgr + ``` + +> Note: These changes are temporary and will be lost during reboot. Should you need to reboot your machine before +> the installation is finished and before the settings are persisted, repeat these commands after each boot. + +> Tip: On HiDPI screens, a larger font might be desirable. E.g. `ter-132b` (the largest font), or +> `ter-118n`. If you need region-specific special characters, set the key map with the `-m` option, +> e.g. `setfont ter-118n -m 88591`. + +## Verify Boot Mode + +[arch-wiki]: https://wiki.archlinux.org/ +[arch-wiki-install]: https://wiki.archlinux.org/title/Installation_guide