diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/install.html | 49 |
1 files changed, 25 insertions, 24 deletions
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 @@ <pre><code>$ curl -O <url> $ curl -O <url>.sha256sum </code></pre> -<p>Verify the checksum of the Alice rootfs tarball:</p> +<p>Verify the checksum of the Alice rootfs tarball.</p> <pre><code>$ sha256sum -c alicelinux-rootfs-20240525.tar.xz.sha256sum -</code></pre> -<p>Make sure it prints:</p> -<pre><code>alicelinux-rootfs-20240525.tar.xz: OK +alicelinux-rootfs-20240525.tar.xz: OK </code></pre> <h2>Prepare the partition and filesystem</h2> <p>Prepare the partition and filesystem of your choice. In this guide, I will use <code>ext4</code> as an example.</p> @@ -117,7 +115,7 @@ $ curl -O <url>.sha256sum <p>NOTE: All repo paths must be declared in the APKG_REPO variable, separated by a single space.</p> </blockquote> <p>Next, we will set up directories for <code>packages</code>, <code>sources</code>, and <code>work</code>. By default, these directories are inside the package template, but we will change them to <code>/var/cache/pkg</code>, <code>/var/cache/src</code>, and <code>/var/cache/work</code> respectively. You can change these to any location where you want to store these files.</p> -<p>First, create the directories:</p> +<p>First, create the directories.</p> <pre><code># mkdir -p /var/cache/pkg # mkdir -p /var/cache/src # mkdir -p /var/cache/work @@ -177,18 +175,18 @@ sway <blockquote> <p>NOTE: The provided kernel will take a lot of time to compile because many options are enabled.</p> </blockquote> -<p>If you want to use Alice's kernel, just run:</p> +<p>If you want to use Alice's kernel, just run.</p> <pre><code># apkg -I linux </code></pre> <h2>Install firmware</h2> -<p>If your hardware requires firmware, install it using:</p> +<p>If your hardware requires firmware, install it using.</p> <pre><code># apkg -I linux-firmware </code></pre> <h2>Install bootloader</h2> -<p>In this guide, I'm going to use <code>grub</code> as the bootloader. Install <code>grub</code>:</p> +<p>In this guide, I'm going to use <code>grub</code> as the bootloader. Install <code>grub</code>.</p> <pre><code># apkg -I grub </code></pre> -<p>Then generate grub config:</p> +<p>Then generate grub config.</p> <pre><code># grub-install /dev/sdX # grub-mkconfig -o /boot/grub/grub.cfg </code></pre> @@ -197,12 +195,12 @@ sway <pre><code># echo alice > /etc/hostname </code></pre> <h2>Fstab</h2> -<p>Change the partition and filesystem of your choice below:</p> +<p>Change the partition and filesystem of your choice below.</p> <pre><code># echo '/dev/sda1 swap swap defaults 0 1' >> /etc/fstab # echo '/dev/sda2 / ext4 defaults 0 0' >> /etc/fstab </code></pre> <h2>Enable runit services</h2> -<p>Alice uses busybox's <code>runit</code> as its main service manager. Enable the required services:</p> +<p>Alice uses busybox's <code>runit</code> as its main service manager. Enable the required services.</p> <pre><code># 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 <p>Create a symlink from <code>/etc/sv/<service></code> to <code>/var/service</code> to enable it; remove the symlink to disable it.</p> </blockquote> <h2>Setup user and password</h2> -<p>Add your user:</p> +<p>Add your user.</p> <pre><code># adduser <user> </code></pre> -<p>Add your user to the <code>wheel</code> group:</p> +<p>Add your user to the <code>wheel</code> group.</p> <pre><code># adduser <user> wheel </code></pre> -<p>You might need to add your user to the <code>input</code> and <code>video</code> groups to start the Wayland compositor later, and the <code>audio</code> group to have working audio:</p> +<p>You might need to add your user to the <code>input</code> and <code>video</code> groups to start the Wayland compositor later, and the <code>audio</code> group to have working audio.</p> <pre><code># adduser <user> input # adduser <user> video # adduser <user> audio </code></pre> <h2>Root password</h2> -<p>Set the password for the <code>root</code> user:</p> +<p>Set the password for the <code>root</code> user.</p> <pre><code># passwd </code></pre> <h2>Networking</h2> -<p>You might want to set up networking before rebooting. Use <code>wpa_supplicant</code> and <code>dhcpcd</code>.</p> -<pre><code># apkg -I wpa_supplicant dhcpcd +<p>You might want to set up networking before rebooting. For wifi connection, install <code>wpa_supplicant</code>.</p> +<pre><code># apkg -I wpa_supplicant </code></pre> -<p>Configure your SSID:</p> +<p>Configure your SSID.</p> <pre><code># wpa_passphrase <YOUR SSID> <ITS PASSWORD> >> /etc/wpa_supplicant.conf </code></pre> -<p>Enable the service:</p> +<p>Enable the service.</p> <pre><code># ln -s /etc/sv/wpa_supplicant /var/service -# ln -s /etc/sv/dhcpcd /var/service +</code></pre> +<p>Then configure & enable <code>udhcpc</code> service.</p> +<pre><code># vi /etc/sv/udhcpc/conf +# ln -s /etc/sv/udhcpc /var/service </code></pre> <h2>Timezone</h2> -<p>Install <code>tzdata</code>:</p> +<p>Install <code>tzdata</code>.</p> <pre><code># apkg -I tzdata </code></pre> -<p>Then create a symlink for your timezone to <code>/etc/localtime</code>:</p> +<p>Then create a symlink for your timezone to <code>/etc/localtime</code>.</p> <pre><code># ln -s /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime </code></pre> -<p>Alternatively, you can copy it and then uninstall <code>tzdata</code> to keep your installed packages minimal:</p> +<p>Alternatively, you can copy it and then uninstall <code>tzdata</code> to keep your installed packages minimal.</p> <pre><code># cp /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime # apkg -r tzdata </code></pre> <h2>Reboot and enjoy!</h2> -<p>Exit the chroot environment and unmount the Alice partition, then reboot:</p> +<p>Exit the chroot environment and unmount the Alice partition, then reboot.</p> <pre><code># exit # umount /mnt/alice # reboot |