From a3f78cc891cbdcda1b1444be9bc8d030e6e0a53f Mon Sep 17 00:00:00 2001 From: Woodpecker CI Date: Tue, 2 Jun 2026 16:09:40 +0000 Subject: Woodpecker CI d81f312365113d2c06e38b7cc8a4654fae72d87f [SKIP CI] --- docs/install.html | 62 ++++++++++++++++++++----------------------------------- 1 file changed, 22 insertions(+), 40 deletions(-) diff --git a/docs/install.html b/docs/install.html index c04cae3a..aac29e84 100644 --- a/docs/install.html +++ b/docs/install.html @@ -184,7 +184,7 @@

Install Alice

Here is a guide to installing Alice Linux on your computer using the chroot method. You can do this from your existing Linux distribution or from a live environment, such as Alice Live or another Linux distribution. Make sure your chosen environment has the necessary partitioning tools, filesystem tools, and extraction tools.

Get Alice rootfs tarball

-

Download the Alice rootfs tarball from the release page, along with its sha256sum file.

+

Download the Alice rootfs tarball from the download page, along with its sha256sum file.

$ curl -O <url>
 $ curl -O <url>.sha256sum
@@ -210,31 +210,31 @@ alicelinux-rootfs-20240525.tar.xz: OK 
# /mnt/alice/usr/bin/apkg-chroot /mnt/alice

Any further commands after this will be executed inside the Alice environment.

-

Configure apkg.conf

-

Once we have the repositories cloned, we need to configure apkg. apkg is Alice's package build system (or package manager). By default, Alice does not provide an apkg config file (yes, apkg can work without a config file), but we need to create one. The apkg config file should be located at /etc/apkg.conf by default. Let's create one.

+

Configure apkg

+

Once we have the repositories cloned, we need to configure apkg. apkg is Alice's package build system (or package manager). apkg configuration is environment-based -- settings are exported as environment variables. Place them in /etc/profile.d/apkg.sh for system-wide configuration, or in ~/.profile for per-user configuration.

First, we set CFLAGS and CXXFLAGS. Alice base packages are built using -O3 -march=x86-64 -pipe. You can use these settings or change them to your preference.

-
# echo 'export CFLAGS="-O3 -march=x86-64 -pipe"' >> /etc/apkg.conf
+
# echo 'export CFLAGS="-O3 -march=x86-64 -pipe"' >> /etc/profile.d/apkg.sh
 

 
And use whats in CFLAGS for CXXFLAGS.

-
# echo 'export CXXFLAGS="$CFLAGS"' >> /etc/apkg.conf
+
# echo 'export CXXFLAGS="$CFLAGS"' >> /etc/profile.d/apkg.sh
 

 
Next set MAKEFLAGS. I will use 6 for my 8 threads machine.

-
# echo 'export MAKEFLAGS="-j6"' >> /etc/apkg.conf
+
# echo 'export MAKEFLAGS="-j6"' >> /etc/profile.d/apkg.sh
 

 
I'm also going to set NINJAJOBS here. Without it, ninja will use all threads of your machine when compiling.

-
# echo 'export NINJAJOBS="6"' >> /etc/apkg.conf
+
# echo 'export NINJAJOBS="6"' >> /etc/profile.d/apkg.sh
 

 
Next, we need to set the package's build scripts path (I'll call it package repos) so apkg can find them. The APKG_REPO variable can accept multiple values for multiple package repos.

 
Alice provides two (2) package repos (at the time of this writing): core and extra. core contains all base packages, and extra includes other packages beyond the base.

 
I'm gonna use directory /var/lib/repos/core and /var/lib/repos/extra for core and extra repos respectively.

-
# echo 'APKG_REPO="/var/lib/repos/core /var/lib/repos/extra"' >> /etc/apkg.conf
+
# echo 'export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra"' >> /etc/profile.d/apkg.sh
 

 
You can also create a directory the community repo.

 

 
NOTE: The community repo is not held to the same standards as the official repos.
 Additionally all repo paths must be declared in the APKG_REPO variable, separated by a single space.

 

-
# echo 'APKG_REPO="/var/lib/repos/core /var/lib/repos/extra /var/lib/repos/community"' >> /etc/apkg.conf
+
# echo 'export APKG_REPO="/var/lib/repos/core /var/lib/repos/extra /var/lib/repos/community"' >> /etc/profile.d/apkg.sh
 

 
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.

@@ -242,21 +242,21 @@ Additionally all repo paths must be declared in the APKG_REPO variable, separate
 # mkdir -p /var/cache/src
 # mkdir -p /var/cache/work
 

-
Then add these paths to /etc/apkg.conf.

-
# echo 'APKG_PACKAGE_DIR=/var/cache/pkg' >> /etc/apkg.conf
-# echo 'APKG_SOURCE_DIR=/var/cache/src' >> /etc/apkg.conf
-# echo 'APKG_WORK_DIR=/var/cache/work' >> /etc/apkg.conf
+
Then add these paths to /etc/profile.d/apkg.sh.

+
# echo 'export APKG_PACKAGE_DIR=/var/cache/pkg' >> /etc/profile.d/apkg.sh
+# echo 'export APKG_SOURCE_DIR=/var/cache/src' >> /etc/profile.d/apkg.sh
+# echo 'export APKG_WORK_DIR=/var/cache/work' >> /etc/profile.d/apkg.sh
 

-
Configure reposync.conf

-
reposync is a tool to sync package templates from git repositories. Add remote repos for core and extra into /etc/reposync.conf. The format of remote repos in reposync.conf is <gitrepo>|<branch>|<localpath>.

-
# echo 'https://codeberg.org/emmett1/alicelinux|core|/var/lib/repos/core' >> /etc/reposync.conf
-# echo 'https://codeberg.org/emmett1/alicelinux|extra|/var/lib/repos/extra' >> /etc/reposync.conf
+
Configure reposync

+
reposync is a tool to sync package templates from git repositories. Like apkg, reposync configuration is environment-based. Add remote repos for core and extra to /etc/profile.d/reposync.sh (system-wide) or ~/.profile (per-user). The format is <gitrepo>|<branch>|<localpath>.

+
# echo 'export REPOSYNC_CORE="https://codeberg.org/emmett1/alicelinux|core|/var/lib/repos/core"' >> /etc/profile.d/reposync.sh
+# echo 'export REPOSYNC_EXTRA="https://codeberg.org/emmett1/alicelinux|extra|/var/lib/repos/extra"' >> /etc/profile.d/reposync.sh
 

 
If you also want the community repo, add it as well.

 

 
NOTE: The community repo is not held to the same standards as the official repos.

 

-
# echo 'https://codeberg.org/emmett1/alicelinux|community|/var/lib/repos/community' >> /etc/reposync.conf
+
# echo 'export REPOSYNC_COMMUNITY="https://codeberg.org/emmett1/alicelinux|community|/var/lib/repos/community"' >> /etc/profile.d/reposync.sh
 

 
Now run reposync to sync latest package templates.

 
# reposync
@@ -309,14 +309,6 @@ NOTE: apkg -a prints all installed packages on the system.

 
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.

-
# apkg -I grub
-

-
Then generate grub config.

-
# grub-install /dev/sdX
-# grub-mkconfig -o /boot/grub/grub.cfg
-

 
Hostname

 
Change alice to the hostname of your choice.

 
# echo alice > /etc/hostname
@@ -353,20 +345,6 @@ Create a symlink from /etc/sv/<service> to /var/service
 
Set the password for the root user.

 
# passwd
 

-
Networking

-
You might want to set up networking before rebooting. For wifi connection, install wpa_supplicant.

-
# apkg -I wpa_supplicant
-

-
Configure your SSID.

-
# wpa_passphrase <YOUR SSID> <ITS PASSWORD> >> /etc/wpa_supplicant.conf
-

-
Enable the service.

-
# ln -s /etc/sv/wpa_supplicant /var/service
-

-
Then configure & enable udhcpc service.

-
# vi /etc/sv/udhcpc/conf
-# ln -s /etc/sv/udhcpc /var/service
-

 
Timezone

 
Install tzdata.

 
# apkg -I tzdata
@@ -378,6 +356,10 @@ Create a symlink from /etc/sv/<service> to /var/service
 
# cp /usr/share/zoneinfo/Asia/Kuala_Lumpur /etc/localtime
 # apkg -r tzdata
 

+
Install bootloader

+
See the bootloader documentation for installing and configuring a bootloader.

+
Networking

+
See the networking documentation for setting up networking.

 
Reboot and enjoy!

 
Exit the chroot environment and unmount the Alice partition, then reboot.

 
# exit
-- 
cgit v1.2.3