aurorad3696e6
README: installing from the ISO
+24 −7
1 file changed
- M README.md +24 −7
| @@ -53,16 +53,33 @@ itself as mono dots, colour dots or the plain photo. | |||
| 53 | 53 | > or support for other setups. It's public as a **reference**, or for people who want **exactly the same | |
| 54 | 54 | > setup** as me. | |
| 55 | 55 | > | |
| 56 | − | > **Only run `install.sh` on a freshly installed, unconfigured Arch Linux system.** It installs a lot of | |
| 57 | − | > packages (NVIDIA drivers included if you pick them), replaces your configs with symlinks, changes your login | |
| 58 | − | > shell and can enable system services. Don't run it on a system you already use. | |
| 56 | + | > **From the Arch ISO, `install.sh` erases the disk you pick.** On an installed system, only run it on a | |
| 57 | + | > freshly installed, unconfigured Arch Linux: it installs a lot of packages (NVIDIA drivers included if you pick | |
| 58 | + | > them), replaces your configs with symlinks, changes your login shell and can enable system services. | |
| 59 | + | > Don't run it on a system you already use. | |
| 59 | 60 | ||
| 60 | − | ## Installing (fresh Arch only) | |
| 61 | + | ## Installing | |
| 62 | + | ### From the Arch ISO (everything) | |
| 63 | + | Boot the [Arch ISO](https://archlinux.org/download/) in UEFI mode, get online (`iwctl` for Wi-Fi), then: | |
| 64 | + | ```bash | |
| 65 | + | bash <(curl -fsSL https://git.krolyxon.com/aurora/raw/master/install.sh) | |
| 66 | + | ``` | |
| 67 | + | It asks everything first, shows a summary and only starts after you type the disk's name. Then it runs on its own: | |
| 68 | + | - disk: **auto** erases a whole disk (1 GiB EFI at `/boot` + the rest), **manual** runs cfdisk and lets you pick | |
| 69 | + | the partitions (an existing EFI partition is kept unformatted for dual boot) | |
| 70 | + | - optional LUKS2 encryption, ext4, zram instead of a swap partition | |
| 71 | + | - `packages/base.txt` + CPU microcode, `linux-zen` (default) and `linux` (fallback), GRUB | |
| 72 | + | - your user with sudo, timezone/locale/keymap, NetworkManager (Wi-Fi joined with `iwctl` carries over) | |
| 73 | + | - the desktop part below, inside the new system, so you reboot straight into Hyprland + aurora (log in on tty1) | |
| 74 | + | ||
| 75 | + | `./install.sh --base` does only the base system. The log ends up in `/var/log/aurora-install.log`. | |
| 76 | + | ||
| 77 | + | ### On an installed Arch (desktop only) | |
| 61 | 78 | ```bash | |
| 62 | 79 | git clone https://git.krolyxon.com/aurora ~/aurora | |
| 63 | 80 | cd ~/aurora | |
| 64 | − | ./install.sh # interactive: pick packages per group | |
| 65 | − | ./install.sh --yes # pre-select the default packages, no pickers | |
| 81 | + | ./install.sh # interactive: pick packages per group (same as --desktop) | |
| 82 | + | ./install.sh --yes # pre-select the default packages, no questions | |
| 66 | 83 | ./install.sh --check # only compare installed packages with the lists, changes nothing | |
| 67 | 84 | ``` | |
| 68 | 85 | Clone it anywhere (e.g. `~/dev/aurora`): the repo's `.stowrc` points stow at `$HOME`. Re-stow by hand with `stow .` | |
| @@ -80,7 +97,7 @@ The lists live in `packages/*.txt`: one package per line, `#` for comments, and | |||
| 80 | 97 | | `gpu.txt` | Intel + NVIDIA (`nvidia-open-dkms`) drivers. Change this for your hardware | | |
| 81 | 98 | | `optional.txt` | desktop apps | | |
| 82 | 99 | | `aur.txt` | AUR packages (installed with paru) | | |
| 83 | − | | `base.txt` | reference only, never installed: what the base install already provides | | |
| 100 | + | | `base.txt` | the base system: what the install from the ISO pacstraps | | |
| 84 | 101 | ||
| 85 | 102 | ## What's inside | |
| 86 | 103 | | | | | |