aboutsummaryrefslogtreecommitdiff
path: root/install.txt
diff options
context:
space:
mode:
Diffstat (limited to 'install.txt')
-rw-r--r--install.txt140
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'.