summaryrefslogtreecommitdiff
path: root/README.md
blob: a5714a9ec13e00f39acc2e7061714c742d7419a2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61


# archinstall

This repository is intended to provide an installation script for Arch Linux so
that it can be used during the installation process.

Note: There are many Arch Install scripts out there but I wanted to create my
own for an educational purpose. So it's mainly a personal repository, but if
you like the script or want to contribute, you're welcome to use it.


## Usage

1. Download the Arch Linux .iso file (maybe [here](http://ftp.halifax.rwth-aachen.de/archlinux/iso/latest/)) and verify it.
2. Write the .iso file to an USB stick (maybe with this [tool](https://www.balena.io/etcher/)) and boot the machine from this USB stick (you could also boot a virtual machine with this .iso file).
3. Change your keyboard layout, if needed (mind the section below).
4. Download the script with 'curl https://cgit.xengineering.eu/archinstall/plain/archinstall.sh > archinstall.sh'.
5. Edit the 'Settings' section with 'nano archinstall.sh', save (CTRL + o) and leave (CTRL + x) the nano editor.
6. Run the script with 'bash archinstall.sh'.


### Change your Keyboard Layout

#### German Keyboard Layout

Execute 'loadkeys de-latin1' after booting to live environment, if you want to
set a german keyboard layout. You have to type 'z' for 'y' in loadkeys and 'ß'
for the '-' sign.


## Done / Features

(Last finished task first)

- [x] Optimize mirrorlist
- [x] Support coloured output
- [x] Support UEFI and BIOS systems
- [x] Automatic abort in case of errors
- [x] Provide full system encryption with LUKS
- [x] Automatic partitioning
- [x] Write first version of archinstall.sh


## To Do / Feature Requests

(Highest priority first)

- [ ] Support NVMe drives
- [ ] Allow user to modify first\_stage.sh and second\_stage.sh
- [ ] Support import of GPG keys for own software repositories
- [ ] Support adding own software repositories
- [ ] Support installation with WiFi (instead of cable connection)
- [ ] Automate testing


## Bugs to solve

- [ ] Add locale en\_US.UTF-8 because it is needed by a software included
- [ ] Sort mirrors with sed command from [Arch Wiki Mirrors Article](https://wiki.archlinux.org/index.php/Mirrors)