summaryrefslogtreecommitdiff
path: root/README
blob: d5deba08fc439aea2c7614de5a8becd8d3171c49 (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
66
67
68
======================================================
Installs Artix Linux with LUKS Root Encryption & BTRFS
======================================================

IMPORTANT:
Script is working on UEFI but not BIOS at the moment.

USAGE:
1. Configure DRIVE & other options in script
2. boot up an Artix Linux live ISO installation
3. login as 'root' with password 'artix'
4. get the installation script onto the system
5. execute script

NOTES:
- DECRYPTION password is set via installation
- default 'root' password is 'artix'
- USER password is the same as the DECRYPTION password

EXAMPLE SYSTEM LAYOUT:
+---------------------------------------------------+
| Device               | Label | Mount       | Size |
|---------------------------------------------------|
| /dev/sda             |       |             |      |
| ├─/dev/sda1          | BOOT  | /boot       | 512M |
| ├─/dev/sda2          | SWAP  | [SWAP]      |  16G |
| └─/dev/sda3          | LUKS  |             |  MAX |
|   └─/dev/mapper/root | ROOT  |             |      |
|     └─@              |       | /           |      |
|     └─@home          |       | /home       |      |
|     └─@snapshots     |       | /.snapshots |      |
+---------------------------------------------------+

CONFIGURATION:
- drive: the drive to perform the installation
- boot: the boot partition
- swap: the swap partition
- root: the root partition

- swap_size: defaults to auto, but can be overwritten
  e.g: 'swap_size=8G'.

- boot_size: defaults to 512M. Can be overwritten
  e.g: 'boot_size=1G'.

- timezone: a timezone (defined in '/usr/share/zoneinfo/').
- locale: a locale (defined in '/etc/locale.gen').
- user: the main user of the system.
- user_groups: the groups 'user' belongs to.
- hostname: the hostname of the system.

- encrypt: whether or not to encrypt the drive

- arch_support: whether to enable Arch repositories.
  (enables extra & multilib)

- enable_aur: specifies whether to install an AUR helper.
  (installs trizen AUR helper)

- autologin: automatically login to user after unlocking drive.
  User password must match decryption password; this is
  the default behaviour when installing, however if you
  update your password be sure to update the decryption
  password to match, or remove '--autologin USER' from
  '/etc/runit/sv/agetty-tty1/conf' to disable this behaviour.

NOTES
Last tested using 'artix-base-runit-20230814-x86_64.iso' on UEFI