Terminal (TUI) installer for Arch Linux written in Rust: guided steps, saved TOML configs, partitioning and boot loader setup, and a clear install plan (including dry-run).
Questions or bugs? Open an issue or join Discussions.
On the Arch live ISO with networking:
curl -fsSL https://github.com/Firstp1ck/archinstall-rs/releases/latest/download/install.sh | bashPass flags through to the installer:
curl -fsSL https://github.com/Firstp1ck/archinstall-rs/releases/latest/download/install.sh | bash -s -- --helpPin a release by swapping latest for a tag path (for example releases/download/vX.X.X/install.sh).
Full install paths (clone + boot.sh, build from source, VM tips): Documents/INSTALL.md.
High level: ratatui-based UI, Rust codebase, disk planning with validated mounts/fstab, TOML save/load, optional LUKS on automatic layouts (experimental), locales and mirrors, NetworkManager or “copy ISO network”, systemd-boot, GRUB, Efistub (experimental, UEFI-only), Limine, desktop-oriented experience mode, optional boot.sh GUI bootstrap.
Details: Documents/FEATURES.md.
| Topic | Location |
|---|---|
| Install, requirements, source build, VM kernel line | Documents/INSTALL.md |
| Current limitations and known issues | Documents/STATUS.md |
| Using the TUI (flow, keybindings, sections) | Documents/USAGE.md |
| TOML configuration | Documents/CONFIGURATION.md |
| Layout, build commands, feature checklist | Documents/DEVELOPMENT.md |
| Roadmap | Documents/ROADMAP.md |
| Troubleshooting and bug reports | Documents/TROUBLESHOOTING.md |
| Releases (notes) | Documents/ (RELEASE_*.md, release_v*.md) |
| Manual / reference | Documents/arch_manual.md |
See CONTRIBUTING.md.
- Arch Linux documentation and community
- ratatui
- archinstall (Python) for inspiration
- Contributors
This tool can repartition disks and change system configuration. Back up important data. Authors are not responsible for data loss or broken systems.
MIT — see LICENSE.