diff options
Diffstat (limited to 'install.txt')
-rw-r--r-- | install.txt | 140 |
1 files changed, 83 insertions, 57 deletions
diff --git a/install.txt b/install.txt index 59e892e..00c7109 100644 --- a/install.txt +++ b/install.txt @@ -1,9 +1,9 @@ - ________________________________ + ________________________________ - CARBS LINUX INSTALLATION GUIDE + CARBS LINUX INSTALLATION GUIDE - Cem Keylan - ________________________________ + Cem Keylan + ________________________________ These are the step-by-step instructions for installing Carbs Linux. It @@ -18,7 +18,6 @@ can be acquired as plain-text to be viewed offline with a pager from .. 1. Download .. 2. Signature verification .. 3. Extracting the tarball -.. 4. Obtain the chroot helper 2. Chroot .. 1. Setting up repositories ..... 1. Obtaining from git @@ -31,6 +30,7 @@ can be acquired as plain-text to be viewed offline with a pager from 3. System Configuration .. 1. Configuring hostname .. 2. Hosts file +.. 3. Creating a user 4. Kernel .. 1. Obtaining the kernel sources .. 2. Kernel dependencies @@ -42,7 +42,8 @@ can be acquired as plain-text to be viewed offline with a pager from .. 2. Init scripts .. 3. Fstab 6. Post-installation -.. 1. KISS repositories +.. 1. IRC +.. 2. KISS repositories 1 Preparing Environment @@ -94,8 +95,8 @@ can be acquired as plain-text to be viewed offline with a pager from The signature file should say something similar to ,---- - | untrusted comment: verify with carbslinux-2021.04.pub - | RWTBBPDVQ+aHB3dme2Kerf8XY+vWkIISp7Za2ufKghtlnRXPyObAQQyvEJYrwMVTaCBlPEnSWcnHQz8Nka06YVOIeextNKZY3AQ= + | untrusted comment: verify with carbslinux-2023.02.pub + | RWTe38zmx+iyuKEL5T84MJ5Y24jqenkTtQLJxbaMzOBS/NkGVl5J+Vn2B6vTV/gJK7LYBPS+IOXV5sEf+YLGCMcBYAGHCcP4xQ8= `---- @@ -107,7 +108,7 @@ can be acquired as plain-text to be viewed offline with a pager from use that instead. ,---- - | PUBKEY=carbslinux-2021.04.pub + | PUBKEY=carbslinux-2023.02.pub | wget https://dl.carbslinux.org/keys/$PUBKEY `---- @@ -143,25 +144,14 @@ can be acquired as plain-text to be viewed offline with a pager from [this guide] <https://wiki.archlinux.org/index.php/Partitioning> -1.4 Obtain the chroot helper -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - You can obtain the `cpt-chroot' script in order to do a simple chroot - into your new root filesystem. - - ,---- - | wget https://dl.carbslinux.org/distfiles/cpt-chroot - | chmod a+x cpt-chroot - `---- - - 2 Chroot ======== - Chroot into Carbs Linux! + Chroot into Carbs Linux by running the chroot helper inside the + rootfs! ,---- - | ./cpt-chroot /mnt + | /mnt/bin/cpt-chroot /mnt `---- @@ -192,8 +182,8 @@ can be acquired as plain-text to be viewed offline with a pager from and GitHub (mirror). Here are both their repository links. You can clone any of them. - - git://git.carbslinux.org/repository - - <https://github.com/carbslinux/repository> + - <https://git.carbslinux.org/repository> + - <https://git.sr.ht/~carbslinux/repository> ,---- | git clone git://git.carbslinux.org/repository $HOME/repos/carbs @@ -207,7 +197,7 @@ can be acquired as plain-text to be viewed offline with a pager from order to obtain it, run the following: ,---- - | rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs + | rsync -avc rsync://vaylin.carbslinux.org/repo $HOME/repos/carbs `---- @@ -220,7 +210,7 @@ can be acquired as plain-text to be viewed offline with a pager from ,---- | CPT_PATH=$HOME/repos/carbs/core | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra - | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg + | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/wayland | CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community | export CPT_PATH `---- @@ -256,7 +246,10 @@ can be acquired as plain-text to be viewed offline with a pager from 2.4 Essential Software ~~~~~~~~~~~~~~~~~~~~~~ - Here is a list of software that you might want to have on your system. + Here is a small list of software that you might want to have on your + system as you are setting up. You might want to check the *Software* + section in the full documentation to learn more about other packaged + software. *BOOTLOADERS* @@ -278,22 +271,6 @@ can be acquired as plain-text to be viewed offline with a pager from - nano - vim - - neatvi - - emacs - - emacs-nox (terminal-only version of emacs) - - *USER SHELLS* - - - bash - - zsh - - oksh - - rc - - *POSIX BASE UTILITIES* - - - busybox - - sbase - - coreutils *DOCUMENTATION* @@ -306,8 +283,8 @@ can be acquired as plain-text to be viewed offline with a pager from ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ All the documentation for Carbs Linux can be found on a single info - manual to be viewed offline. You can obtain texinfo or the info - (standalone) package in order to view the documentation. + manual to be viewed offline. You can obtain either `texinfo' or the + `info' packages in order to view the documentation. ,---- | # Install the documentation. @@ -355,6 +332,37 @@ can be acquired as plain-text to be viewed offline with a pager from `---- +3.3 Creating a user +~~~~~~~~~~~~~~~~~~~ + + Creating a new user is not strictly necessary, but it is highly + recommended. Especially for building packages, it is the safest + option to create an unprivileged user and using `doas' for doing + operations that require `root' privileges. The code block below + describes how to create a user (named `foo'), add them to the wheel + group, and to give doas permissions to the wheel group + + ,---- + | # Create the new user + | adduser foo + | + | # Add the user to the wheel group + | addgroup foo wheel + | + | # Give root permission to the wheel group using doas + | echo permit persist :wheel >> /etc/doas.conf + `---- + + You are also advised to take a look at the doas configuration file and + the manual page of doas. + + After you are finished you can switch to the new user by running + + ,---- + | su foo + `---- + + 4 Kernel ======== @@ -372,17 +380,22 @@ can be acquired as plain-text to be viewed offline with a pager from You can visit the <https://kernel.org> website to choose a kernel that you want to install. Though only the latest stable and longterm (LTS) - versions are supported. + versions are supported. Note that kernel releases are quite rapid, and + the version below is likely outdated, so don't run it verbatim. ,---- | # Download the kernel and extract it - | wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.9.1.tar.xz - | tar xf linux-5.9.1.tar.xz + | wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.19.4.tar.xz + | tar xJf linux-5.19.4.tar.xz | | # Change directory into the kernel sources - | cd linux-5.9.1 + | cd linux-5.19.4 `---- + *NOTE:* If you want to validate the kernel signature, install the + `gnupg2' package, and follow the instructions provided at + <https://kernel.org/category/signatures.html>. + 4.2 Kernel dependencies ~~~~~~~~~~~~~~~~~~~~~~~ @@ -468,8 +481,8 @@ can be acquired as plain-text to be viewed offline with a pager from | cpt b grub && cpt i grub | | grub-install --target=x86_64-efi \ - | --efi-directory=esp \ - | --bootloader-id=CarbsLinux + | --efi-directory=esp \ + | --bootloader-id=CarbsLinux | | grub-mkconfig -o /boot/grub/grub.cfg `---- @@ -509,10 +522,23 @@ can be acquired as plain-text to be viewed offline with a pager from learn more about the system. -6.1 KISS repositories +6.1 IRC +~~~~~~~ + + The IRC channel for Carbs Linux is located in `#carbslinux' on + [libera.chat]. You can install the `catgirl' package from the + repository, or use a client of your preference to join. Feel free to + ask for help, or have a general chat. + + +[libera.chat] <https://libera.chat> + + +6.2 KISS repositories ~~~~~~~~~~~~~~~~~~~~~ - While not 100% compatible with cpt, you can use kiss repositories in - your system the same way you are using the distribution - repositories. Here is an example for the KISS Linux Community - repository. + There have been recent changes to the `kiss' package manager that + breaks compatibility with `cpt'. These changes throw away the entire + premise of their "static" packaging system. `cpt' will never implement + those changes, so don't expect any KISS package that was changed + during or after July 2021 to work with `cpt'. |