commit acad25a3a1b307d52b47569c1d0977313beca582
parent 17064f0bb521a139eec7d69748cf4267cd4531c4
Author: emmett1 <emmett1.2miligrams@protonmail.com>
Date: Sat, 27 Sep 2025 08:08:33 +0200
Update website/docs/install.md
Diffstat:
1 file changed, 26 insertions(+), 25 deletions(-)
diff --git a/website/docs/install.md b/website/docs/install.md
@@ -12,13 +12,9 @@ $ curl -O <url>
$ curl -O <url>.sha256sum
```
-Verify the checksum of the Alice rootfs tarball:
+Verify the checksum of the Alice rootfs tarball.
```
$ sha256sum -c alicelinux-rootfs-20240525.tar.xz.sha256sum
-```
-
-Make sure it prints:
-```
alicelinux-rootfs-20240525.tar.xz: OK
```
@@ -93,7 +89,7 @@ I'm gonna use directory `/var/lib/repos/core` and `/var/lib/repos/extra` for `co
Next, we will set up directories for `packages`, `sources`, and `work`. By default, these directories are inside the package template, but we will change them to `/var/cache/pkg`, `/var/cache/src`, and `/var/cache/work` respectively. You can change these to any location where you want to store these files.
-First, create the directories:
+First, create the directories.
```
# mkdir -p /var/cache/pkg
# mkdir -p /var/cache/src
@@ -175,7 +171,7 @@ You can configure your own kernel from [kernel.org](https://kernel.org/) or use
> NOTE: The provided kernel will take a lot of time to compile because many options are enabled.
-If you want to use Alice's kernel, just run:
+If you want to use Alice's kernel, just run.
```
# apkg -I linux
```
@@ -183,7 +179,7 @@ If you want to use Alice's kernel, just run:
Install firmware
----------------
-If your hardware requires firmware, install it using:
+If your hardware requires firmware, install it using.
```
# apkg -I linux-firmware
```
@@ -191,12 +187,12 @@ If your hardware requires firmware, install it using:
Install bootloader
------------------
-In this guide, I'm going to use `grub` as the bootloader. Install `grub`:
+In this guide, I'm going to use `grub` as the bootloader. Install `grub`.
```
# apkg -I grub
```
-Then generate grub config:
+Then generate grub config.
```
# grub-install /dev/sdX
# grub-mkconfig -o /boot/grub/grub.cfg
@@ -213,7 +209,7 @@ Change `alice` to the hostname of your choice.
Fstab
-----
-Change the partition and filesystem of your choice below:
+Change the partition and filesystem of your choice below.
```
# echo '/dev/sda1 swap swap defaults 0 1' >> /etc/fstab
# echo '/dev/sda2 / ext4 defaults 0 0' >> /etc/fstab
@@ -222,7 +218,7 @@ Change the partition and filesystem of your choice below:
Enable runit services
---------------------
-Alice uses busybox's `runit` as its main service manager. Enable the required services:
+Alice uses busybox's `runit` as its main service manager. Enable the required services.
```
# ln -s /etc/sv/tty1 /var/service
# ln -s /etc/sv/tty2 /var/service
@@ -237,17 +233,17 @@ I'm enabling 3 `tty` services. `tty` is required; without it, you won't be able
Setup user and password
-----------------------
-Add your user:
+Add your user.
```
# adduser <user>
```
-Add your user to the `wheel` group:
+Add your user to the `wheel` group.
```
# adduser <user> wheel
```
-You might need to add your user to the `input` and `video` groups to start the Wayland compositor later, and the `audio` group to have working audio:
+You might need to add your user to the `input` and `video` groups to start the Wayland compositor later, and the `audio` group to have working audio.
```
# adduser <user> input
# adduser <user> video
@@ -257,7 +253,7 @@ You might need to add your user to the `input` and `video` groups to start the W
Root password
-------------
-Set the password for the `root` user:
+Set the password for the `root` user.
```
# passwd
```
@@ -265,36 +261,41 @@ Set the password for the `root` user:
Networking
----------
-You might want to set up networking before rebooting. Use `wpa_supplicant` and `dhcpcd`.
+You might want to set up networking before rebooting. For wifi connection, install `wpa_supplicant`.
```
-# apkg -I wpa_supplicant dhcpcd
+# apkg -I wpa_supplicant
```
-Configure your SSID:
+Configure your SSID.
```
# wpa_passphrase <YOUR SSID> <ITS PASSWORD> >> /etc/wpa_supplicant.conf
```
-Enable the service:
+Enable the service.
```
# ln -s /etc/sv/wpa_supplicant /var/service
-# ln -s /etc/sv/dhcpcd /var/service
+```
+
+Then configure & enable `udhcpc` service.
+```
+# vi /etc/sv/udhcpc/conf
+# ln -s /etc/sv/udhcpc /var/service
```
Timezone
--------
-Install `tzdata`:
+Install `tzdata`.
```
# apkg -I tzdata
```
-Then create a symlink for your timezone to `/etc/localtime`:
+Then create a symlink for your timezone to `/etc/localtime`.
```
# ln -s /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime
```
-Alternatively, you can copy it and then uninstall `tzdata` to keep your installed packages minimal:
+Alternatively, you can copy it and then uninstall `tzdata` to keep your installed packages minimal.
```
# cp /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime
# apkg -r tzdata
@@ -303,7 +304,7 @@ Alternatively, you can copy it and then uninstall `tzdata` to keep your installe
Reboot and enjoy!
-----------------
-Exit the chroot environment and unmount the Alice partition, then reboot:
+Exit the chroot environment and unmount the Alice partition, then reboot.
```
# exit
# umount /mnt/alice
