aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorWoodpecker CI <emmett1.2miligrams@protonmail.com>2025-09-27 06:08:49 +0000
committerWoodpecker CI <emmett1.2miligrams@protonmail.com>2025-09-27 06:08:49 +0000
commitecf06e18c35f7cad6e7a06919cacddcf570177e6 (patch)
tree47698e5062ec796b1f0d336bdc06f3fed7adbdae /docs
parent40672647d80898260cfa545dbe994b2059f17bfd (diff)
downloadalicelinux-ecf06e18c35f7cad6e7a06919cacddcf570177e6.tar.gz
alicelinux-ecf06e18c35f7cad6e7a06919cacddcf570177e6.zip
Woodpecker CI acad25a3a1b307d52b47569c1d0977313beca582 [SKIP CI]
Diffstat (limited to 'docs')
-rw-r--r--docs/install.html49
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 &lt;url&gt;
$ curl -O &lt;url&gt;.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 &lt;url&gt;.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 &gt; /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' &gt;&gt; /etc/fstab
# echo '/dev/sda2 / ext4 defaults 0 0' &gt;&gt; /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/&lt;service&gt;</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 &lt;user&gt;
</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 &lt;user&gt; 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 &lt;user&gt; input
# adduser &lt;user&gt; video
# adduser &lt;user&gt; 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 &lt;YOUR SSID&gt; &lt;ITS PASSWORD&gt; &gt;&gt; /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 &amp; 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