main 6af0a61

README.md RawHistoryFolder

ArchUp is an opinionated Arch Linux installer that picks the boring defaults so you don't have to.

What It Decides

  • Btrfs with @ and @home subvolumes
  • Limine bootloader (UEFI only)
  • Chaotic-AUR enabled
  • Plymouth boot splash
  • Snapper for snapshot-based rollbacks
  • NetworkManager, OpenSSH, zram, firewalld

What You Choose

  • Disk and optional LUKS2 encryption
  • Hostname, user, locale, timezone, keymap
  • Kernel: linux, linux-lts, linux-zen, linux-hardened, linux-cachyos
  • AMD P-State mode (auto-detected per Zen generation)
  • GPU drivers (auto-detected)
  • Extra repos (CachyOS, AUR helper)
  • Dank Linux desktop on first boot (optional)

Quick Start

Requirements: x86_64, UEFI, Secure Boot disabled

Boot the Arch ISO and run:

curl -fsSL https://archup.run/install | bash

Reboot when done.

What Gets Installed

Base packages: base, linux-firmware, btrfs-progs, limine, efibootmgr, plymouth, networkmanager, openssh, firewalld, sudo, neovim, man-db, git, zram-generator, Fira Sans, JetBrains Mono Nerd Font

Extra packages: snapper, snap-pac, base-devel, Go, Rust/Cargo, GTK3/4/libadwaita, Qt5/6 + Wayland, GStreamer, ffmpeg, Pipewire, Bluetooth (bluez), WiFi (iwd), modern CLI tools (eza, zoxide, fzf, ripgrep, bat, fd, btop, nvtop, yazi, starship, jq, git-delta, dust, duf, tealdeer, tree)

First-boot service (automatic):

  • Snapper configured for Btrfs snapshots
  • firewalld enabled
  • SSH host keys generated
  • ble.sh and shell tooling installed
  • Optional display manager opt-in

Status

Active development, tested on real hardware.

  • TUI installer
  • LUKS2 encryption
  • First-boot systemd service
  • Dank Linux desktop (niri/Hyprland)

Report bugs with logs from /var/log/archup.log.

Acknowledgments

  • Omarchy for the modular architecture approach
  • Charmbracelet for the TUI toolkit (Bubble Tea, Lipgloss, Huh)
source
1<p align="center">
2  <img src="assets/archup-logo-v2-5.png" alt="ArchUp Logo" width="600">
3</p>
4
5ArchUp is an opinionated Arch Linux installer that picks the boring defaults so you don't have to.
6
7## What It Decides
8
9- Btrfs with `@` and `@home` subvolumes
10- Limine bootloader (UEFI only)
11- Chaotic-AUR enabled
12- Plymouth boot splash
13- Snapper for snapshot-based rollbacks
14- NetworkManager, OpenSSH, zram, firewalld
15
16## What You Choose
17
18- Disk and optional LUKS2 encryption
19- Hostname, user, locale, timezone, keymap
20- Kernel: `linux`, `linux-lts`, `linux-zen`, `linux-hardened`, `linux-cachyos`
21- AMD P-State mode (auto-detected per Zen generation)
22- GPU drivers (auto-detected)
23- Extra repos (CachyOS, AUR helper)
24- Dank Linux desktop on first boot (optional)
25
26## Quick Start
27
28**Requirements:** x86_64, UEFI, Secure Boot disabled
29
30Boot the Arch ISO and run:
31
32```bash
33curl -fsSL https://archup.run/install | bash
34```
35
36Reboot when done.
37
38## What Gets Installed
39
40**Base packages:** `base`, `linux-firmware`, `btrfs-progs`, `limine`, `efibootmgr`, `plymouth`, `networkmanager`, `openssh`, `firewalld`, `sudo`, `neovim`, `man-db`, `git`, `zram-generator`, Fira Sans, JetBrains Mono Nerd Font
41
42**Extra packages:** `snapper`, `snap-pac`, `base-devel`, Go, Rust/Cargo, GTK3/4/libadwaita, Qt5/6 + Wayland, GStreamer, ffmpeg, Pipewire, Bluetooth (bluez), WiFi (iwd), modern CLI tools (`eza`, `zoxide`, `fzf`, `ripgrep`, `bat`, `fd`, `btop`, `nvtop`, `yazi`, `starship`, `jq`, `git-delta`, `dust`, `duf`, `tealdeer`, `tree`)
43
44**First-boot service (automatic):**
45- Snapper configured for Btrfs snapshots
46- firewalld enabled
47- SSH host keys generated
48- ble.sh and shell tooling installed
49- Optional display manager opt-in
50
51## Status
52
53Active development, tested on real hardware.
54
55- [x] TUI installer
56- [x] LUKS2 encryption
57- [x] First-boot systemd service
58- [x] Dank Linux desktop (niri/Hyprland)
59
60Report bugs with logs from `/var/log/archup.log`.
61
62## Acknowledgments
63
64- [Omarchy](https://github.com/omakub/omakub) for the modular architecture approach
65- [Charmbracelet](https://github.com/charmbracelet) for the TUI toolkit (Bubble Tea, Lipgloss, Huh)

Keyboard shortcuts

Single-key shortcuts are on. ctrl k and esc work whatever this says.

ctrl k :
go to a section, branch, tag, file or repository
?
this list
j k
move the row cursor down / up
enter
open the row under the cursor; on Files, a directory opens or closes in place
↑ ↓ ← → home end
in the file tree (focus on a row): previous / next row, close / open a directory or go to its parent / first entry, first / last row. They never open a file
l h
on Files: open a directory or a file / close a directory or go up to its parent, then to the parent page. Elsewhere: into the side panel (on a merge request, its files) / back to the content; there j k move between its controls
g g G
first / last row
/
filter the list; on Files, find a file anywhere in the repository (esc clears, enter opens the best match)
b
switch branch or tag
g s g f g c g b g m g i g r g a
tabs: summary, files, commits, branches & tags, merge requests, issues, releases, actions (when available)
g h
home
w
wide mode: use the whole width of the screen, or not (remembered)
y
copy a permalink pinned to the commit
d u x
diff: split / unified / collapse or expand all
e E
diff: the whole file in view / every file, with the lines the hunks hide
n
merge request: next note in the diff
esc
close a dialog, leave a field

Branches 1

Tags 0

    ↑↓ moveenter openesc close