summaryrefslogtreecommitdiff
path: root/README.md
blob: e875a93bfa70f723c63835936728752bfecd03a2 (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
62
63
64
65


# 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 to an USB stick (maybe with this [tool](https://www.balena.io/etcher/)) and boot the machine from this USB stick in UEFI mode.
3. Download the script with 'curl -L archinstall.xengineering.eu > archinstall.sh'.
4. Run the script with 'bash archinstall.sh' and follow the instructions.


### Hint for German Users

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.


### Usage with VirtualBox

1. Create a VirtualBox virtual machine (VM) for 64-bit Arch Linux with the default or customized settings.
2. Enable Extensible Firmware Interface (EFI) in the settings of this VM.
3. Start the VM and provide the .iso file if you are asked to.
4. You booted the Arch Linux live environment in VirtualBox. Proceed with the normal use of archinstall.


## Restrictions

- Just UEFI systems
- Just german localization of the installed system
- Just installation with cable network connection (no WiFi)


## To Do

(Highest priority first)

- [ ] Use LVM
- [ ] Create swap partition
- [ ] Enable suspension to disk
- [ ] Optimize mirrorlist
- [ ] Automatic abort in case of errors
- [ ] Support installation with WiFi (instead of cable connection)
- [ ] Provide recommended package lists
- [ ] Set a beautiful theme
- [ ] Support BIOS systems
- [ ] Support english localization
- [ ] Package for the AUR


## Done

(Last finished task first)

- [x] Provide full system encryption with LUKS
- [x] Create a main user with sudo permissions
- [x] Provide installation of a desktop environment
- [x] Provide reusable configuration file (json)
- [x] Provide error log
- [x] Automatic partitioning
- [x] Write first version of archinstall.sh