@@ -42,63 +43,63 @@ acquired as plain-text to be viewed offline with a pager from

1. Preparing Environment +
1. Preparing Environment
2. Chroot +
2. Chroot
3. System Configuration +
3. System Configuration
4. Kernel +
4. Kernel
5. Making your system bootable +
5. Making your system bootable
6. Post-installation +
6. Post-installation
- 6.1. KISS repositories
- 6.1. KISS repositories

1 Preparing Environment

To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you @@ -123,8 +124,8 @@ will continue on that point.

1.1 Download

First, we need to download the rootfs tarball. You can do the following in order @@ -141,8 +142,8 @@ sha256sum -c carbs-rootfs.tar.xz.sha256

1.2 Signature verification

It is highly recommended to verify the signature of the tarball. You will need @@ -158,8 +159,8 @@ gpg --verify carbs-rootfs.tar.xz.sig

1.3 Extracting the tarball

You will need to extract the tarball to your desired location. For partitioning, @@ -175,8 +176,8 @@ tar xf carbs-rootfs.tar.xz -C /mnt

1.4 Obtain the chroot helper

You can obtain the cpt-chroot script in order to do a simple chroot into your @@ -192,8 +193,8 @@ chmod a+x cpt-chroot

2 Chroot

Chroot into Carbs Linux! @@ -205,8 +206,8 @@ Chroot into Carbs Linux!

2.1 Setting up repositories

Newest tarballs do not come with repositories, so you will need to manually @@ -229,8 +230,8 @@ ahead and create that directory:

2.1.1 Obtaining from git

Carbs Linux git repositories can be found both from the main server and GitHub @@ -249,8 +250,8 @@ Carbs Linux git repositories can be found both from the main server and GitHub

2.1.2 Obtaining from rsync

Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In @@ -264,8 +265,8 @@ order to obtain it, run the following:

2.1.3 Making the package manager use the repositories

In your shell's configuration file, or in your ~/.profile file, add the @@ -284,8 +285,8 @@ following lines:

2.2 Updating packages

It is good practice to make sure your system is up to date, especially before @@ -300,8 +301,8 @@ need to update twice.

2.3 Installing packages

Since you are operating on a really small base, you might need to build and @@ -318,8 +319,8 @@ cpt-install package

2.4 Essential Software

Here is a list of software that you might want to have on your system. @@ -398,8 +399,8 @@ Here is a list of software that you might want to have on your system.

2.5 Obtaining the documentation

All the documentation for Carbs Linux can be found on a single info manual to be @@ -423,8 +424,8 @@ info carbslinux

3 System Configuration

After you have finished installing some extra packages, you can configure your @@ -432,8 +433,8 @@ system to your liking.

3.1 Configuring hostname

You might want to add a hostname, especially in a networked environment. Your @@ -447,8 +448,8 @@ hostname will default to 'carbslinux' unless you set this.

3.2 Hosts file

You can edit your /etc/hosts file, which is the static lookup table for host @@ -456,7 +457,7 @@ names. By default, there are two entries for localhost which are OKAY. You can replace the 'localhost' part of these entries to your hostname.

+ 127.0.0.1  localhost.localdomain localhost
 ::1        localhost.localdomain localhost ip6-localhost
 
@@ -464,8 +465,8 @@ replace the 'localhost' part of these entries to your hostname.

4 Kernel

Kernel isn't managed under the main repositories, even though you could package @@ -474,8 +475,8 @@ need to reconfigure for your specific setup if you want to make use of it.

4.1 Obtaining the kernel sources

You can visit the https://kernel.org website to choose a kernel that you want @@ -495,8 +496,8 @@ tar xf linux-5.9.1.tar.xz

4.2 Kernel dependencies

In order to compile the kernel you will need to install some dependencies. You @@ -526,8 +527,8 @@ patch -p1 < kernel-no-perl.patch

4.3 Building the kernel

Next step is configuring and building the kernel. You can check Gentoo's @@ -546,8 +547,8 @@ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux

5 Making your system bootable

In order to be able to boot your fresh system, wou will need an init-daemon, @@ -556,8 +557,8 @@ but you can optionally change it.

5.1 Bootloader

In the main repository, there is efibootmgr and grub to serve as bootloaders. @@ -567,8 +568,8 @@ without UEFI support (or you really want to use BIOS for a reason).

5.1.1 GRUB BIOS installation

cpt b grub && cpt i grub
@@ -579,8 +580,8 @@ grub-mkconfig -o /boot/grub/grub.cfg

5.1.2 GRUB UEFI installation

cpt b efibootmgr && cpt i efibootmgr
@@ -597,8 +598,8 @@ grub-mkconfig -o /boot/grub/grub.cfg

5.2 Init scripts

Only thing left to do is installing the init-scripts, and now you are almost @@ -612,8 +613,8 @@ ready to boot your system!

5.3 Fstab

You can now manually edit your fstab entry, or you can use the genfstab tool. @@ -630,8 +631,8 @@ chmod +x genfstab

6 Post-installation

The base installation is now complete, you can now fine tune your system @@ -640,8 +641,8 @@ You can check the rest of the documentation to learn more about the system.

6.1 KISS repositories

While not 100% compatible with cpt, you can use kiss repositories in your -- cgit v1.2.3