From ecf06e18c35f7cad6e7a06919cacddcf570177e6 Mon Sep 17 00:00:00 2001 From: Woodpecker CI Date: Sat, 27 Sep 2025 06:08:49 +0000 Subject: Woodpecker CI acad25a3a1b307d52b47569c1d0977313beca582 [SKIP CI] --- docs/install.html | 49 +++++++++++++++++++++++++------------------------ 1 file changed, 25 insertions(+), 24 deletions(-) (limited to 'docs') diff --git a/docs/install.html b/docs/install.html index a41a5e0c..df09b883 100644 --- a/docs/install.html +++ b/docs/install.html @@ -70,11 +70,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
+alicelinux-rootfs-20240525.tar.xz: OK

Prepare the partition and filesystem

Prepare the partition and filesystem of your choice. In this guide, I will use ext4 as an example.

@@ -117,7 +115,7 @@ $ curl -O <url>.sha256sum

NOTE: All repo paths must be declared in the APKG_REPO variable, separated by a single space.

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
 # mkdir -p /var/cache/work
@@ -177,18 +175,18 @@ sway
 

 
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
 

 
Install firmware

-
If your hardware requires firmware, install it using:

+
If your hardware requires firmware, install it using.

 
# apkg -I linux-firmware
 

 
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
 

@@ -197,12 +195,12 @@ sway
 
# echo alice > /etc/hostname
 

 
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
 

 
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
 # ln -s /etc/sv/tty3 /var/service
@@ -213,45 +211,48 @@ sway
 
Create a symlink from /etc/sv/<service> to /var/service to enable it; remove the symlink to disable it.

 
 
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
 # adduser <user> audio
 

 
Root password

-
Set the password for the root user:

+
Set the password for the root user.

 
# passwd
 

 
Networking

-
You might want to set up networking before rebooting. Use wpa_supplicant and dhcpcd.

-
# apkg -I wpa_supplicant dhcpcd
+
You might want to set up networking before rebooting. For wifi connection, install wpa_supplicant.

+
# 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
 

 
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
 # reboot
-- 
cgit v1.2.3