summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBlake Romero <blake@blkrom.com>2023-05-24 21:48:02 +0100
committerBlake Romero <blake@blkrom.com>2023-05-24 21:48:02 +0100
commit7deea41638cbe6da413e701600603a2935590b1f (patch)
treea363f6bd4c127b7ed579910ffe4675928adf5929
parentec50b0865be80bba2cbaa66e99914c0e5c9b0de5 (diff)
Add more details to README
-rw-r--r--README66
-rwxr-xr-xinstall-artix.sh31
2 files changed, 53 insertions, 44 deletions
diff --git a/README b/README
index c54bd9e..a7e79bd 100644
--- a/README
+++ b/README
@@ -1,28 +1,64 @@
======================================================
-Install Artix Linux with LUKS Root Encryption & BTRFS
+Installs Artix Linux with LUKS Root Encryption & BTRFS
======================================================
Working on: UEFI
-Usage:
-1. IMPORTANT! configure DRIVE options in CONFIG section.
+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:
+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 1G
-├─/dev/sda2 SWAP [SWAP] 16G
-└─/dev/sda3 LUKS MAX
- └─/dev/mapper/root ROOT
- └─@ /
- └─@home /home
- └─@snapshots /.snapshots
+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 (which will be encrypted)
+
+- 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 for 'user' belongs to
+
+- hostname: the hostname of the system
+
+- arch_support: whether enable Arch repositories
+ (enables extra, community, & multilib)
+
+- enable_aur: specifies whether to install an AUR helper
+ (uses trizen as AUR helper)
+
+- swap_size: Defaults to formula, but can be overwritten
+ e.g: 'swap_size=8G'.
+
+- boot_size: Defaults to 512M. Can be overwritten
+ in CONFIG e.g: boot_size=1G.
+
+NOTES
+Last tested using 'artix-base-runit-20230501-x86_64.iso' on UEFI \ No newline at end of file
diff --git a/install-artix.sh b/install-artix.sh
index 29e48d7..587126a 100755
--- a/install-artix.sh
+++ b/install-artix.sh
@@ -1,33 +1,6 @@
#!/bin/bash
-# ======================================================
-# Install Artix Linux with LUKS Root Encryption & BTRFS
-# ======================================================
-#
-# Usage:
-# 1. IMPORTANT! configure DRIVE options in CONFIG section.
-# 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 1G
-# ├─/dev/sda2 SWAP [SWAP] 16G
-# └─/dev/sda3 LUKS MAX
-# └─/dev/mapper/root ROOT
-# └─@ /
-# └─@home /home
-# └─@snapshots /.snapshots
-#
-#
+# Installs Artix Linux With LUKS Root Encryption & BTRFS
+# See README for further details
# ======================================================
# CONFIG
# ======================================================