From a13be81f89f44679553e640b57c18565396dafa7 Mon Sep 17 00:00:00 2001 From: sommerfeld Date: Tue, 21 Apr 2026 01:23:38 +0100 Subject: docs(readme): document pre-bootstrap user creation Make the 'wheel user must already exist' prerequisite explicit with a three-line useradd/passwd snippet, rather than leaving it implicit in bootstrap.sh's preconditions. --- README.md | 21 +++++++++++++-------- 1 file changed, 13 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 8ae2b57..1b43116 100644 --- a/README.md +++ b/README.md @@ -4,25 +4,30 @@ My Arch Linux configuration, managed with [chezmoi](https://www.chezmoi.io/). ## Bootstrap on a fresh Arch install -As the regular wheel user (not root), on a minimal Arch system (only -`base` installed): +`bootstrap.sh` assumes the Arch installation guide has been followed up +to the point of having a booted system with a wheel-group user. On a +minimal system (only `base` installed), prepare the user once as root: + +```sh +pacman -S --needed sudo +useradd -m -G wheel -s /bin/bash +passwd +``` + +Then log in as that user and run: ```sh curl -fsSL https://raw.githubusercontent.com/sommerfelddev/dotfiles/master/bootstrap.sh | sh ``` -This installs pacman prerequisites, enables `%wheel` in sudoers, builds -`paru-bin` from the AUR, clones this repo to `~/dotfiles`, runs +The script installs pacman prerequisites, enables `%wheel` in sudoers, +builds `paru-bin` from the AUR, clones this repo to `~/dotfiles`, runs `just init`, enables recommended systemd units (fstrim, timesyncd, resolved, reflector, paccache, pkgstats, acpid, cpupower, iwd, plus tlp on laptops), refreshes the pacman mirrorlist, creates XDG user directories, and — on EFI systems missing an Arch boot entry — launches `create-efi`. -The script assumes the Arch installation guide has already been -followed up to the point of creating a wheel-group user and booting -into their session. - ## Setup on an existing system ```sh -- cgit v1.2.3-70-g09d2