https://github.com/cryptexctl/frachi
frachi aka Fuck RACHInstall - fully rewritten archinstall
https://github.com/cryptexctl/frachi
arch-linux archlinux linux
Last synced: 7 months ago
JSON representation
frachi aka Fuck RACHInstall - fully rewritten archinstall
- Host: GitHub
- URL: https://github.com/cryptexctl/frachi
- Owner: cryptexctl
- Created: 2025-06-09T08:18:46.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-29T06:42:55.000Z (9 months ago)
- Last Synced: 2025-06-29T07:33:30.756Z (9 months ago)
- Topics: arch-linux, archlinux, linux
- Language: Go
- Homepage:
- Size: 2.83 MB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# frachi
**Fuck RACHInstall** — minimalistic, fast, and transparent Arch Linux installer written in Go. This is a modern, scriptable, and hackable alternative to archinstall, focused on clarity, full control, and real-time feedback.
> **Download prebuilt binary:**
> [Latest frachi build (nightly.link)](https://nightly.link/cryptexctl/frachi/workflows/build/main?preview)
## What is frachi?
frachi (Fuck RACHInstall) is a Go-based CLI installer for Arch Linux, designed for advanced users who want:
- Full control over disk selection, partitioning, and formatting
- Only the essential drivers and packages for a working system
- Real-time logs for all installation steps
- No magic, no hidden logic, no bloat
- Easy scripting and reproducibility
## Features
- **Written in Go**: fast, portable, easy to hack
- **No auto-partitioning**: you choose and format partitions yourself (or via CLI flags)
- **Interactive or CLI**: select partitions interactively or via `--efi`, `--root`, `--swap` flags
- **Automatic hardware detection**: only necessary drivers (NVIDIA, AMD, Intel) are installed
- **Real-time logs**: pacstrap and all key commands output directly to your terminal
- **Minimal base system**: only `base`, `linux`, `linux-firmware` and drivers
- **Grub by default**: only grub bootloader is supported (systemd-boot is NOT (i hate systemd))
- **Swap support**: if swap partition is present, it will be enabled
- **Safe**: never touches partitions you don't select and always asks before formatting
- **English only**: all output and prompts are in English
- **Reconfiguration mode**: use `--afterbase` to skip base install and only reconfigure users, bootloader, etc.
## Usage
1. **Prepare your disk** (partition and format manually, e.g. with `cfdisk`, `mkfs.ext4`, `mkfs.fat`, `mkswap`)
2. Boot into Arch ISO, copy frachi binary to the live system
3. Run:
```sh
./frachi --disk /dev/sda --password --user alice:pass --user bob:pass --sudo --addsudo alice --doas --adddoas bob
```
Optionally add:
- `--efi /dev/sda1` (EFI partition)
- `--root /dev/sda2` (root partition)
- `--swap /dev/sda3` (swap partition)
- `--hostname`, `--locale`, `--timezone`, etc.
- `--afterbase` (skip base install, only reconfigure)
If you don't specify partitions, frachi will prompt you to enter device paths interactively.
4. Follow the prompts, confirm formatting if needed, and watch the real-time logs.
5. When finished, reboot into your new system!
## Example
```
./frachi --disk /dev/sda --password 123456789 --user alice:pass --user bob:pass --sudo --addsudo alice --doas --adddoas bob
```
## Troubleshooting
- **No partitions found on disk**: Make sure you have partitioned and formatted your disk. Only real partitions (like `/dev/sda1`, `/dev/sda2`) are shown.
- **Failed to mount partition**: Check that the partition is formatted (ext4 for root, vfat for EFI) and not in use.
- **No internet in chroot**: frachi copies `/etc/resolv.conf` automatically, but if you still have no DNS, check `/mnt/etc/resolv.conf`.
- **SSL/certificate errors**: frachi runs `update-ca-trust` in chroot, but if you see SSL errors, try running it manually in chroot.
- **pacstrap or chroot errors**: Check the logs in your terminal for details. Most issues are due to missing partitions, wrong formats, or missing network.
- **UEFI grub-install error: efibootmgr: not found**: For UEFI systems, you must install `efibootmgr` (`pacman -S efibootmgr` in chroot) before running grub-install.
- **Want to reconfigure without reinstalling base?**: Use `--afterbase` to skip base install and only reconfigure users, bootloader, etc.
- **Any other issues**: Please open an issue on GitHub with your terminal output and a description. The developer has no problems, so if you do — report it!
## Contributing
PRs and issues are welcome. The code is intentionally simple and modular — hack away!