Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shimarulin/archi
Dead simple and minimal Arch Linux installer
https://github.com/shimarulin/archi
Last synced: 10 days ago
JSON representation
Dead simple and minimal Arch Linux installer
- Host: GitHub
- URL: https://github.com/shimarulin/archi
- Owner: shimarulin
- License: mit
- Created: 2021-04-30T22:30:09.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-02-07T00:46:45.000Z (about 2 years ago)
- Last Synced: 2024-04-25T02:51:30.627Z (10 months ago)
- Language: Rust
- Homepage:
- Size: 168 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Archi
> Just another simple and minimal Arch Linux installer
### Principles
- Use the original Arch Linux installation image
- Use minimal but sufficient setup
- Use the most automated installation and configuration process
### Features
- UEFI and BIOS compatible GPT disk layout and bootloader (used GRUB2): you can use the disk with the installed system
in another computer with UEFI or BIOS without any changes in most use cases
- Detect user timezone automatically
- Btrfs subvolumes
- Add new user with `sudo` for granting administrator privileges to a user
- Login for `root` user is disabled by default
- Used NetworkManager for manage connections
### Installation and usage
You should boot from Arch Linux installation image, download installer binary, set executable permission, and run it:
```shell
# Download https://github.com/shimarulin/archi/releases/latest/download/archi
# with Curl
curl -L https://git.io/JGRV3 --output archi
# or Wget
wget https://git.io/JGRV3 -O archi
# Mark the file as executable
chmod +x archi
# Run
./archi
```
### Notes for installed system
If you move the disc after installation to another computer with UEFI, do not forget to generate a new UEFI menu item (`/dev/sda` - your disk with installed Arch Linux):
```shell
efibootmgr -c -d /dev/sda -p 2 -L "Arch Linux" -l "\EFI\BOOT\BOOTX64.EFI"
```
## Development
### Git hooks
Run in project root to set Git hooks directory:
```shell
git config core.hooksPath .hooks
```
### Development dependencies
To extend Cargo functionality I'm use https://github.com/killercup/cargo-edit. To compile it, you need to install the openssl development package.
For example, `libssl-dev` on Ubuntu:
```shell
sudo apt install libssl-dev && cargo install cargo-edit
```
or `openssl-devel` on Fedora.
Install development tools:
```shell
cargo install cargo-edit cocogitto cargo-bump
```
### Build
#### error[E0554]: `#![feature]` may not be used on the stable release channel
From https://github.com/dtolnay/thiserror/issues/192#issuecomment-1246276720:
```shell
cargo clean
```
#### Optimizing the size of the executable file
- https://lifthrasiir.github.io/rustlog/why-is-a-rust-executable-large.html
- https://github.com/johnthagen/min-sized-rust
Cargo.toml:
```toml
# Release optimization
[profile.release]
opt-level = 'z' # Optimize for size.
lto = true
panic = 'abort'
```
Shell command:
```shell
cargo build --release && strip target/release/archi
```
#### Use Docker to build with musl
```shell
docker run -v $PWD:/volume -w /volume -t clux/muslrust cargo build
```
See more on https://github.com/clux/muslrust
### How to test on Virtualbox
#### Setup SSH connection
1. Add default VirtualBox Network:
1. _File_ > _Tools_ > _Network Manager_ > _Host-only Networks_ > _Create_ (you will get `vboxnet0`)
2. Select `vboxnet0` _Properties_ > _DHCP Server_ > _Enable Server_
2. Setup VM Network: VM's _Settings_ > _Network_ > _Adapter 2_ > select _Host-only Adapter_ (vboxnet0)
3. Run VM and load guest OS:
1. Setup password: `passwd`
2. Start the SSH service in the guest OS is not running, start it (`systemctl start sshd`)
3. Show IP on host OS: `ip addr show`, get IP for vboxnet0 (192.168.43.91, for example)
4. Connect from host: `ssh -o 'IdentitiesOnly=yes' [email protected]`
#### Send file from host to guest via SSH
```shell
scp -o 'IdentitiesOnly=yes' ./archi [email protected]:/root/
```