diff options
| author | emmett1 <emmett1.2miligrams@protonmail.com> | 2025-10-02 04:28:55 +0000 |
|---|---|---|
| committer | emmett1 <emmett1.2miligrams@protonmail.com> | 2025-10-02 04:28:55 +0000 |
| commit | 8a398b2ed80d03c99bb2b11010bb2e205a8d4aef (patch) | |
| tree | 5d58f8cbc981d7573247a1f411d2172bee4fa9e3 /website/docs/install.md | |
| parent | aa51a99247bc0620f2f076103c88e1effa1b8d06 (diff) | |
| parent | 8eb800dab0c1105abde56eaa356fbabd5ecbdc3a (diff) | |
| download | alicelinux-8a398b2ed80d03c99bb2b11010bb2e205a8d4aef.tar.gz alicelinux-8a398b2ed80d03c99bb2b11010bb2e205a8d4aef.zip | |
Merge branch 'main' of https://codeberg.org/emmett1/alicelinux
Diffstat (limited to 'website/docs/install.md')
| -rw-r--r-- | website/docs/install.md | 51 |
1 files changed, 26 insertions, 25 deletions
diff --git a/website/docs/install.md b/website/docs/install.md index 155d9ecc..923d76f7 100644 --- 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 |