diff options
| -rw-r--r-- | docs/docs/Installation.html | 3 | ||||
| -rw-r--r-- | docs/docs/Preparing-Environment.html | 10 | ||||
| -rw-r--r-- | docs/docs/install.html | 390 | ||||
| -rw-r--r-- | docs/docs/install.txt | 361 | ||||
| -rw-r--r-- | docs/news.xml | 2 | ||||
| -rw-r--r-- | docs/rss.xml | 2 | ||||
| -rw-r--r-- | src/docs/Installation.html | 3 | ||||
| -rw-r--r-- | src/docs/Preparing-Environment.html | 10 | ||||
| -rw-r--r-- | src/docs/install.txt | 361 | ||||
| -rw-r--r-- | src/news.xml | 2 | ||||
| -rw-r--r-- | src/rss.xml | 2 | ||||
| m--------- | texidocs | 0 |
12 files changed, 1134 insertions, 12 deletions
diff --git a/docs/docs/Installation.html b/docs/docs/Installation.html index 48c83c3..5077314 100644 --- a/docs/docs/Installation.html +++ b/docs/docs/Installation.html @@ -49,6 +49,9 @@ Next: <a href="Package-Manager.html" accesskey="n" rel="next">Package Manager</a <p>These are the step-by-step instructions for installing Carbs Linux. </p> +<p>The instructions can also be found plaintext on +<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a> +</p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="Preparing-Environment.html" accesskey="1">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot </td></tr> diff --git a/docs/docs/Preparing-Environment.html b/docs/docs/Preparing-Environment.html index 476299d..e222594 100644 --- a/docs/docs/Preparing-Environment.html +++ b/docs/docs/Preparing-Environment.html @@ -65,10 +65,12 @@ will continue on that point. <p>First, we need to download the rootfs tarball. You can do the following in order to obtain the rootfs. If you are using an i686 machine, replace the <code>x86_64</code> -with <code>i686</code>. +with <code>i686</code>. We are setting this in a URL variable so that we don’t have to +write it every time. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz +<pre class="example">$ URL=https://dl.carbslinux.org/releases/x86_64 +$ wget $URL/carbs-rootfs.tar.xz </pre></div> <p>We can then check the integrity of the tarball and do a signature verification. @@ -81,7 +83,7 @@ latest release is saved on <samp>carbs-rootfs.tar.xz.sha256</samp>. You can acqu verify the tarball. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256 +<pre class="example">$ wget $URL/carbs-rootfs.tar.xz.sha256 $ sha256sum -c carbs-rootfs.tar.xz.sha256 </pre></div> @@ -91,7 +93,7 @@ $ sha256sum -c carbs-rootfs.tar.xz.sha256 GPG for this. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/carbs-rootfs.tar.xz.sig +<pre class="example">$ wget $URL/carbs-rootfs.tar.xz.sig $ gpg --recv-keys FF484BDFEFCEF8FF $ gpg --verify carbs-rootfs.tar.xz.sig </pre></div> diff --git a/docs/docs/install.html b/docs/docs/install.html new file mode 100644 index 0000000..2143c5e --- /dev/null +++ b/docs/docs/install.html @@ -0,0 +1,390 @@ +<!DOCTYPE HTML> +<html lan=en> + <head> + <title>install | Carbs Linux</title> + <link rel="stylesheet" href="/style.css"> + <meta charset="utf-8"> + <meta name="Description" content="Carbs Linux - a simple linux distribution"> + <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> + </head> + <body> + <p class=header><strong>Carbs Linux - a simple linux distribution</strong></p> + <div class="header"> + <nav> + <a href='/'>index</a> + <a href="//git.carbslinux.org">git</a> + <a href='//dl.carbslinux.org'>downloads</a> + <a href='/blog'>blog</a> + <a href='/docs/Installation.html'>installation</a> + <a href='/docs'>user manual</a> + </nav> + </div><div class="border"></div> +<pre> +1 Installation +************** + +These are the step-by-step instructions for installing Carbs Linux. + +1.1 Preparing Environment +========================= + +To install Carbs Linux, you will need a Live Linux ISO. For that +purpose, you can obtain a Gentoo or Void Linux live image. You can +follow their instructions to boot and setup your network. + + You will need the following programs in order to install Carbs Linux: + * tar + * wget + * xz + * some form of base utilities (coreutils, sbase, busybox, etc.) + + Rest of these instructions will assume that you have set all of these +up, and will continue on that point. + +1.1.1 Download +-------------- + +First, we need to download the rootfs tarball. You can do the following +in order to obtain the rootfs. If you are using an i686 machine, +replace the 'x86_64' with 'i686'. We are setting this in a URL variable +so that we don't have to write it every time. + + $ URL=<a href=https://dl.carbslinux.org/releases/x86_64>https://dl.carbslinux.org/releases/x86_64</a> + $ wget $URL/carbs-rootfs.tar.xz + + We can then check the integrity of the tarball and do a signature +verification. Even thought these are optional, they are highly +recommended. + +1.1.2 Check the integrity of the tarball (Recommended) +------------------------------------------------------ + +All of the releases are saved in a single file named 'sha256sums.txt', +but the latest release is saved on 'carbs-rootfs.tar.xz.sha256'. You +can acquire and verify the tarball. + + $ wget $URL/carbs-rootfs.tar.xz.sha256 + $ sha256sum -c carbs-rootfs.tar.xz.sha256 + +1.1.3 Verify the signature +-------------------------- + +It is highly recommended to verify the signature of the tarball. You +will need GPG for this. + + $ wget $URL/carbs-rootfs.tar.xz.sig + $ gpg --recv-keys FF484BDFEFCEF8FF + $ gpg --verify carbs-rootfs.tar.xz.sig + +1.1.4 Extracting the tarball +---------------------------- + +You will need to extract the tarball to your desired location. For +partitioning, you can follow this guide +(<a href=https://wiki.archlinux.org/index.php/Partitioning>https://wiki.archlinux.org/index.php/Partitioning</a>). This will assume +that you will be mounting your root partition to '/mnt'. + + $ mount /dev/sdx1 /mnt + $ tar xf carbs-rootfs.tar.xz -C /mnt + +1.1.5 Obtain the chroot helper +------------------------------ + +You can obtain the 'cpt-chroot' script in order to do a simple chroot +into your new root filesystem. + + $ wget <a href=https://dl.carbslinux.org/distfiles/cpt-chroot>https://dl.carbslinux.org/distfiles/cpt-chroot</a> + $ chmod a+x cpt-chroot + +1.2 Chroot +========== + +Chroot into Carbs Linux! + + $ ./cpt-chroot /mnt + +1.2.1 Setting up repositories +----------------------------- + +Newest tarballs do not come with repositories, so you will need to +manually obtain them, and set your 'CPT_PATH' environment variable. +Carbs Linux repositories can either be obtained by 'git' or 'rsync'. +While rsync repositories are overall faster and smaller, git offers the +whole history of the repository and a means to manipulate your +repository as you like it. If you want to obtain the git repository, +you will need to install 'git' itself. + + The following guide will assume that you put the repositories into +'~/repos/' directory, but you can put the repositories into any +directory you want. So go ahead and create that directory. 'mkdir -p +$HOME/repos'. + +1.2.1.1 Obtaining from rsync +............................ + +Carbs Linux rsync repositories live in <rsync://carbslinux.org/repo>. +In order to obtain it, run the following: + + $ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs + +1.2.1.2 Obtaining from git +.......................... + +Carbs Linux git repositories can be found both from the main server and +GitHub (mirror). Here are both their repository links. You can clone +any of them. + + * <git://git.carbslinux.org/repository> + * <<a href=https://github.com/carbslinux/repository>>https://github.com/carbslinux/repository></a> + + $ git clone git://git.carbslinux.org/repository $HOME/repos/carbs + +1.2.1.3 Making the package manager use the repositories +....................................................... + +In your shell's configuration file, or in your '~/.profile' file, add +the following lines: + + export CPT_PATH='' + CPT_PATH=$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/community + export CPT_PATH + +1.2.2 Updating packages +----------------------- + +It is good practice to make sure your system is up to date, especially +before building new packages. If there is an update for the package +manager you will need to update twice. + + $ cpt update + +1.2.3 Installing packages +------------------------- + +Since you are operating on a really small base, you might need to build +and install new programs to extend the functionality of your system. In +order to build and install packages new packages in Carbs, you need to +execute the following. "Package" is not actually a package and is given +as an example. + + $ cpt build package + $ cpt install package + +1.2.4 Essential Software +------------------------ + +Here is a list of software that you might want to have on your system. + + BOOTLOADERS + * efibootmgr + * grub + FILESYSTEMS + * e2fsprogs + * dosfstools + * ntfs-3g + NETWORKING + * dhcpcd + * wpa_supplicant + TEXT EDITORS + * nano + * vim + * neatvi + * nvi + * emacs + * emacs-nox (terminal-only version of emacs) + USER SHELLS + * bash + * zsh + * dash + * oksh + * rc + POSIX BASE UTILITIES + * busybox + * sbase + * coreutils + DOCUMENTATION + * carbs-docs + * man-pages + * man-pages-posix + +1.2.5 Obtaining the documentation (optional) +-------------------------------------------- + +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. + + Install the documentation. + $ cpt b carbs-docs && cpt i carbs-docs + + Install either texinfo or the info package. We will be installing standalone info + as it doesn't need perl. + $ cpt b info && cpt i info + + You can then run info and navigate through the documentation. + $ info carbslinux + +1.3 System Configuration +======================== + +After you have finished installing some extra packages, you can +configure your system to your liking. + +1.3.1 Configuring hostname (recommended) +---------------------------------------- + +You might want to add a hostname, especially in a networked environment. +Your hostname will default to 'carbslinux' unless you set this. + + $ echo your-hostname > /etc/hostname + +1.3.2 Setting up hosts file (optional) +-------------------------------------- + +You can edit your /etc/hosts file, which is the static lookup table for +host 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 + +1.4 Kernel +========== + +Kernel isn't managed under the main repositories, even though you could +package one for your personal use. Here is an example kernel package +(<a href=https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux>https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux</a>), +which you will need to reconfigure for your specific setup if you want +to make use of it. + +1.4.1 Obtaining the kernel sources +---------------------------------- + +You can visit the <a href=https://kernel.org>https://kernel.org</a> website to choose a kernel that you +want to install. Though only the latest stable and longterm (LTS) +versions are supported. + + Download the kernel and extract it + $ wget <a href=https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.7.6.tar.xz>https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.7.6.tar.xz</a> + $ tar xf linux-5.7.6.tar.xz + + Change directory into the kernel sources + $ cd linux-5.7.6 + +1.4.2 Installing dependencies +----------------------------- + +In order to compile the kernel you will need to install some +dependencies. You will need 'libelf' to compile the kernel. If you +want to configure using the menu interface you will also need 'ncurses'. + + The package manager asks to install if you are building more than one package, + so no need to run 'cpt i ...' + $ cpt b libelf ncurses + + In the vanilla kernel sources, you need perl to compile the kernel, +but it can be easily patched out. You will need to apply the following +patch. Patch was written by E5ten (<a href=https://github.com/E5ten>https://github.com/E5ten</a>). You will +need to obtain and apply the patch in the kernel source directory. + + $ wget <a href=https://dl.carbslinux.org/distfiles/kernel-no-perl.patch>https://dl.carbslinux.org/distfiles/kernel-no-perl.patch</a> + $ patch -p1 < kernel-no-perl.patch + +1.4.3 Compiling the kernel +-------------------------- + +Next step is configuring and building the kernel. You can check +Gentoo's kernel configuration guide +(<a href=https://wiki.gentoo.org/wiki/Kernel/Configuration>https://wiki.gentoo.org/wiki/Kernel/Configuration</a>) to learn more about +the matter. Overall, Gentoo Wiki is a good place to learn about +configuration according to your hardware. The following will assume a +monolithic kernel. + + $ make menuconfig + $ make + $ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux + +1.5 Making your system bootable +=============================== + +In order to be able to boot your fresh system, wou will need an +init-daemon, init-scripts and a bootloader. The init daemon is already +provided by busybox, but you can optionally change it. + +1.5.1 Installing a bootloader +----------------------------- + +In the main repository, there is efibootmgr and grub to serve as +bootloaders. efibootmgr can be used as a standalone bootloader, or can +be used to install grub in a UEFI environment. efibootmgr is needed +unless you are using a device without UEFI support (or you really want +to use BIOS for a reason). + + GRUB BIOS installation + + $ cpt b grub && cpt i grub + $ grub-install --target=i386-pc /dev/sdX + $ grub-mkconfig -o /boot/grub/grub.cfg + + GRUB UEFI installation + + $ cpt b efibootmgr && cpt i efibootmgr + $ cpt b grub && cpt i grub + + $ grub-install --target=x86_64-efi \ + --efi-directory=esp \ + --bootloader-id=CarbsLinux + + $ grub-mkconfig -o /boot/grub/grub.cfg + +1.5.2 Installing init scripts +----------------------------- + +Only thing left to do is installing the init-scripts, and now you are +almost ready to boot your system! + + $ cpt b carbs-init && cpt i carbs-init + +1.5.3 Generating fstab +---------------------- + +You can now manually edit your fstab entry, or you can use the genfstab +tool. If you want to use the tool, exit the chroot and run the +following: + + $ wget <a href=https://github.com/cemkeylan/genfstab/raw/master/genfstab>https://github.com/cemkeylan/genfstab/raw/master/genfstab</a> + $ chmod +x genfstab + $ ./genfstab -U /mnt >> /mnt/etc/fstab + +1.6 Post-installation +===================== + +The base installation is now complete, you can now fine tune your system +according to your needs. Rest of these instructions are completely +optional. + +1.6.1 Acquiring 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. + + $ git clone <a href=https://github.com/kisslinux/community>https://github.com/kisslinux/community</a> $HOME/repos/kiss-community + $ export CPT_PATH=$CPT_PATH:$HOME/repos/kiss-community/community + + NOTE: There are lots of packages on the KISS community repository +that are also on Carbs Linux main repository. I would advise giving +lower priority to the KISS community repository as it may affect other +packages that you might install. +</pre> + <a href="/docs/install.txt">View Page Source</a> + <div class="border"></div> + <p class=footer>Linux® is a registered trademark of Linus Torvalds</p> + <p class=footer>Copyright © 2019-2020 Cem Keylan</p> + </body> +</html> diff --git a/docs/docs/install.txt b/docs/docs/install.txt new file mode 100644 index 0000000..2dba19e --- /dev/null +++ b/docs/docs/install.txt @@ -0,0 +1,361 @@ +1 Installation +************** + +These are the step-by-step instructions for installing Carbs Linux. + +1.1 Preparing Environment +========================= + +To install Carbs Linux, you will need a Live Linux ISO. For that +purpose, you can obtain a Gentoo or Void Linux live image. You can +follow their instructions to boot and setup your network. + + You will need the following programs in order to install Carbs Linux: + * tar + * wget + * xz + * some form of base utilities (coreutils, sbase, busybox, etc.) + + Rest of these instructions will assume that you have set all of these +up, and will continue on that point. + +1.1.1 Download +-------------- + +First, we need to download the rootfs tarball. You can do the following +in order to obtain the rootfs. If you are using an i686 machine, +replace the 'x86_64' with 'i686'. We are setting this in a URL variable +so that we don't have to write it every time. + + $ URL=https://dl.carbslinux.org/releases/x86_64 + $ wget $URL/carbs-rootfs.tar.xz + + We can then check the integrity of the tarball and do a signature +verification. Even thought these are optional, they are highly +recommended. + +1.1.2 Check the integrity of the tarball (Recommended) +------------------------------------------------------ + +All of the releases are saved in a single file named 'sha256sums.txt', +but the latest release is saved on 'carbs-rootfs.tar.xz.sha256'. You +can acquire and verify the tarball. + + $ wget $URL/carbs-rootfs.tar.xz.sha256 + $ sha256sum -c carbs-rootfs.tar.xz.sha256 + +1.1.3 Verify the signature +-------------------------- + +It is highly recommended to verify the signature of the tarball. You +will need GPG for this. + + $ wget $URL/carbs-rootfs.tar.xz.sig + $ gpg --recv-keys FF484BDFEFCEF8FF + $ gpg --verify carbs-rootfs.tar.xz.sig + +1.1.4 Extracting the tarball +---------------------------- + +You will need to extract the tarball to your desired location. For +partitioning, you can follow this guide +(https://wiki.archlinux.org/index.php/Partitioning). This will assume +that you will be mounting your root partition to '/mnt'. + + $ mount /dev/sdx1 /mnt + $ tar xf carbs-rootfs.tar.xz -C /mnt + +1.1.5 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 + +1.2 Chroot +========== + +Chroot into Carbs Linux! + + $ ./cpt-chroot /mnt + +1.2.1 Setting up repositories +----------------------------- + +Newest tarballs do not come with repositories, so you will need to +manually obtain them, and set your 'CPT_PATH' environment variable. +Carbs Linux repositories can either be obtained by 'git' or 'rsync'. +While rsync repositories are overall faster and smaller, git offers the +whole history of the repository and a means to manipulate your +repository as you like it. If you want to obtain the git repository, +you will need to install 'git' itself. + + The following guide will assume that you put the repositories into +'~/repos/' directory, but you can put the repositories into any +directory you want. So go ahead and create that directory. 'mkdir -p +$HOME/repos'. + +1.2.1.1 Obtaining from rsync +............................ + +Carbs Linux rsync repositories live in <rsync://carbslinux.org/repo>. +In order to obtain it, run the following: + + $ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs + +1.2.1.2 Obtaining from git +.......................... + +Carbs Linux git repositories can be found both from the main server 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> + + $ git clone git://git.carbslinux.org/repository $HOME/repos/carbs + +1.2.1.3 Making the package manager use the repositories +....................................................... + +In your shell's configuration file, or in your '~/.profile' file, add +the following lines: + + export CPT_PATH='' + CPT_PATH=$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/community + export CPT_PATH + +1.2.2 Updating packages +----------------------- + +It is good practice to make sure your system is up to date, especially +before building new packages. If there is an update for the package +manager you will need to update twice. + + $ cpt update + +1.2.3 Installing packages +------------------------- + +Since you are operating on a really small base, you might need to build +and install new programs to extend the functionality of your system. In +order to build and install packages new packages in Carbs, you need to +execute the following. "Package" is not actually a package and is given +as an example. + + $ cpt build package + $ cpt install package + +1.2.4 Essential Software +------------------------ + +Here is a list of software that you might want to have on your system. + + BOOTLOADERS + * efibootmgr + * grub + FILESYSTEMS + * e2fsprogs + * dosfstools + * ntfs-3g + NETWORKING + * dhcpcd + * wpa_supplicant + TEXT EDITORS + * nano + * vim + * neatvi + * nvi + * emacs + * emacs-nox (terminal-only version of emacs) + USER SHELLS + * bash + * zsh + * dash + * oksh + * rc + POSIX BASE UTILITIES + * busybox + * sbase + * coreutils + DOCUMENTATION + * carbs-docs + * man-pages + * man-pages-posix + +1.2.5 Obtaining the documentation (optional) +-------------------------------------------- + +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. + + Install the documentation. + $ cpt b carbs-docs && cpt i carbs-docs + + Install either texinfo or the info package. We will be installing standalone info + as it doesn't need perl. + $ cpt b info && cpt i info + + You can then run info and navigate through the documentation. + $ info carbslinux + +1.3 System Configuration +======================== + +After you have finished installing some extra packages, you can +configure your system to your liking. + +1.3.1 Configuring hostname (recommended) +---------------------------------------- + +You might want to add a hostname, especially in a networked environment. +Your hostname will default to 'carbslinux' unless you set this. + + $ echo your-hostname > /etc/hostname + +1.3.2 Setting up hosts file (optional) +-------------------------------------- + +You can edit your /etc/hosts file, which is the static lookup table for +host 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 + +1.4 Kernel +========== + +Kernel isn't managed under the main repositories, even though you could +package one for your personal use. Here is an example kernel package +(https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux), +which you will need to reconfigure for your specific setup if you want +to make use of it. + +1.4.1 Obtaining the kernel sources +---------------------------------- + +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. + + Download the kernel and extract it + $ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.7.6.tar.xz + $ tar xf linux-5.7.6.tar.xz + + Change directory into the kernel sources + $ cd linux-5.7.6 + +1.4.2 Installing dependencies +----------------------------- + +In order to compile the kernel you will need to install some +dependencies. You will need 'libelf' to compile the kernel. If you +want to configure using the menu interface you will also need 'ncurses'. + + The package manager asks to install if you are building more than one package, + so no need to run 'cpt i ...' + $ cpt b libelf ncurses + + In the vanilla kernel sources, you need perl to compile the kernel, +but it can be easily patched out. You will need to apply the following +patch. Patch was written by E5ten (https://github.com/E5ten). You will +need to obtain and apply the patch in the kernel source directory. + + $ wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch + $ patch -p1 < kernel-no-perl.patch + +1.4.3 Compiling the kernel +-------------------------- + +Next step is configuring and building the kernel. You can check +Gentoo's kernel configuration guide +(https://wiki.gentoo.org/wiki/Kernel/Configuration) to learn more about +the matter. Overall, Gentoo Wiki is a good place to learn about +configuration according to your hardware. The following will assume a +monolithic kernel. + + $ make menuconfig + $ make + $ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux + +1.5 Making your system bootable +=============================== + +In order to be able to boot your fresh system, wou will need an +init-daemon, init-scripts and a bootloader. The init daemon is already +provided by busybox, but you can optionally change it. + +1.5.1 Installing a bootloader +----------------------------- + +In the main repository, there is efibootmgr and grub to serve as +bootloaders. efibootmgr can be used as a standalone bootloader, or can +be used to install grub in a UEFI environment. efibootmgr is needed +unless you are using a device without UEFI support (or you really want +to use BIOS for a reason). + + GRUB BIOS installation + + $ cpt b grub && cpt i grub + $ grub-install --target=i386-pc /dev/sdX + $ grub-mkconfig -o /boot/grub/grub.cfg + + GRUB UEFI installation + + $ cpt b efibootmgr && cpt i efibootmgr + $ cpt b grub && cpt i grub + + $ grub-install --target=x86_64-efi \ + --efi-directory=esp \ + --bootloader-id=CarbsLinux + + $ grub-mkconfig -o /boot/grub/grub.cfg + +1.5.2 Installing init scripts +----------------------------- + +Only thing left to do is installing the init-scripts, and now you are +almost ready to boot your system! + + $ cpt b carbs-init && cpt i carbs-init + +1.5.3 Generating fstab +---------------------- + +You can now manually edit your fstab entry, or you can use the genfstab +tool. If you want to use the tool, exit the chroot and run the +following: + + $ wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + $ chmod +x genfstab + $ ./genfstab -U /mnt >> /mnt/etc/fstab + +1.6 Post-installation +===================== + +The base installation is now complete, you can now fine tune your system +according to your needs. Rest of these instructions are completely +optional. + +1.6.1 Acquiring 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. + + $ git clone https://github.com/kisslinux/community $HOME/repos/kiss-community + $ export CPT_PATH=$CPT_PATH:$HOME/repos/kiss-community/community + + NOTE: There are lots of packages on the KISS community repository +that are also on Carbs Linux main repository. I would advise giving +lower priority to the KISS community repository as it may affect other +packages that you might install. diff --git a/docs/news.xml b/docs/news.xml index 7cf1650..319cae7 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Sep 10 2020 11:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> <item> <title>Sep 03 2020</title> <pubDate>Thu, 03 Sep 2020</pubDate> diff --git a/docs/rss.xml b/docs/rss.xml index cf2fe4b..1980970 100644 --- a/docs/rss.xml +++ b/docs/rss.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Sep 10 2020 11:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> <item> <title>August 2020 News Post</title> <pubDate>Mon, 03 Aug 2020</pubDate> diff --git a/src/docs/Installation.html b/src/docs/Installation.html index 48c83c3..5077314 100644 --- a/src/docs/Installation.html +++ b/src/docs/Installation.html @@ -49,6 +49,9 @@ Next: <a href="Package-Manager.html" accesskey="n" rel="next">Package Manager</a <p>These are the step-by-step instructions for installing Carbs Linux. </p> +<p>The instructions can also be found plaintext on +<a href="https://carbslinux.org/docs/install.txt">https://carbslinux.org/docs/install.txt</a> +</p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="Preparing-Environment.html" accesskey="1">Preparing Environment</a></td><td> </td><td align="left" valign="top">Getting ready to chroot </td></tr> diff --git a/src/docs/Preparing-Environment.html b/src/docs/Preparing-Environment.html index 476299d..e222594 100644 --- a/src/docs/Preparing-Environment.html +++ b/src/docs/Preparing-Environment.html @@ -65,10 +65,12 @@ will continue on that point. <p>First, we need to download the rootfs tarball. You can do the following in order to obtain the rootfs. If you are using an i686 machine, replace the <code>x86_64</code> -with <code>i686</code>. +with <code>i686</code>. We are setting this in a URL variable so that we don’t have to +write it every time. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz +<pre class="example">$ URL=https://dl.carbslinux.org/releases/x86_64 +$ wget $URL/carbs-rootfs.tar.xz </pre></div> <p>We can then check the integrity of the tarball and do a signature verification. @@ -81,7 +83,7 @@ latest release is saved on <samp>carbs-rootfs.tar.xz.sha256</samp>. You can acqu verify the tarball. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256 +<pre class="example">$ wget $URL/carbs-rootfs.tar.xz.sha256 $ sha256sum -c carbs-rootfs.tar.xz.sha256 </pre></div> @@ -91,7 +93,7 @@ $ sha256sum -c carbs-rootfs.tar.xz.sha256 GPG for this. </p> <div class="example"> -<pre class="example">$ wget https://dl.carbslinux.org/releases/carbs-rootfs.tar.xz.sig +<pre class="example">$ wget $URL/carbs-rootfs.tar.xz.sig $ gpg --recv-keys FF484BDFEFCEF8FF $ gpg --verify carbs-rootfs.tar.xz.sig </pre></div> diff --git a/src/docs/install.txt b/src/docs/install.txt new file mode 100644 index 0000000..2dba19e --- /dev/null +++ b/src/docs/install.txt @@ -0,0 +1,361 @@ +1 Installation +************** + +These are the step-by-step instructions for installing Carbs Linux. + +1.1 Preparing Environment +========================= + +To install Carbs Linux, you will need a Live Linux ISO. For that +purpose, you can obtain a Gentoo or Void Linux live image. You can +follow their instructions to boot and setup your network. + + You will need the following programs in order to install Carbs Linux: + * tar + * wget + * xz + * some form of base utilities (coreutils, sbase, busybox, etc.) + + Rest of these instructions will assume that you have set all of these +up, and will continue on that point. + +1.1.1 Download +-------------- + +First, we need to download the rootfs tarball. You can do the following +in order to obtain the rootfs. If you are using an i686 machine, +replace the 'x86_64' with 'i686'. We are setting this in a URL variable +so that we don't have to write it every time. + + $ URL=https://dl.carbslinux.org/releases/x86_64 + $ wget $URL/carbs-rootfs.tar.xz + + We can then check the integrity of the tarball and do a signature +verification. Even thought these are optional, they are highly +recommended. + +1.1.2 Check the integrity of the tarball (Recommended) +------------------------------------------------------ + +All of the releases are saved in a single file named 'sha256sums.txt', +but the latest release is saved on 'carbs-rootfs.tar.xz.sha256'. You +can acquire and verify the tarball. + + $ wget $URL/carbs-rootfs.tar.xz.sha256 + $ sha256sum -c carbs-rootfs.tar.xz.sha256 + +1.1.3 Verify the signature +-------------------------- + +It is highly recommended to verify the signature of the tarball. You +will need GPG for this. + + $ wget $URL/carbs-rootfs.tar.xz.sig + $ gpg --recv-keys FF484BDFEFCEF8FF + $ gpg --verify carbs-rootfs.tar.xz.sig + +1.1.4 Extracting the tarball +---------------------------- + +You will need to extract the tarball to your desired location. For +partitioning, you can follow this guide +(https://wiki.archlinux.org/index.php/Partitioning). This will assume +that you will be mounting your root partition to '/mnt'. + + $ mount /dev/sdx1 /mnt + $ tar xf carbs-rootfs.tar.xz -C /mnt + +1.1.5 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 + +1.2 Chroot +========== + +Chroot into Carbs Linux! + + $ ./cpt-chroot /mnt + +1.2.1 Setting up repositories +----------------------------- + +Newest tarballs do not come with repositories, so you will need to +manually obtain them, and set your 'CPT_PATH' environment variable. +Carbs Linux repositories can either be obtained by 'git' or 'rsync'. +While rsync repositories are overall faster and smaller, git offers the +whole history of the repository and a means to manipulate your +repository as you like it. If you want to obtain the git repository, +you will need to install 'git' itself. + + The following guide will assume that you put the repositories into +'~/repos/' directory, but you can put the repositories into any +directory you want. So go ahead and create that directory. 'mkdir -p +$HOME/repos'. + +1.2.1.1 Obtaining from rsync +............................ + +Carbs Linux rsync repositories live in <rsync://carbslinux.org/repo>. +In order to obtain it, run the following: + + $ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs + +1.2.1.2 Obtaining from git +.......................... + +Carbs Linux git repositories can be found both from the main server 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> + + $ git clone git://git.carbslinux.org/repository $HOME/repos/carbs + +1.2.1.3 Making the package manager use the repositories +....................................................... + +In your shell's configuration file, or in your '~/.profile' file, add +the following lines: + + export CPT_PATH='' + CPT_PATH=$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/community + export CPT_PATH + +1.2.2 Updating packages +----------------------- + +It is good practice to make sure your system is up to date, especially +before building new packages. If there is an update for the package +manager you will need to update twice. + + $ cpt update + +1.2.3 Installing packages +------------------------- + +Since you are operating on a really small base, you might need to build +and install new programs to extend the functionality of your system. In +order to build and install packages new packages in Carbs, you need to +execute the following. "Package" is not actually a package and is given +as an example. + + $ cpt build package + $ cpt install package + +1.2.4 Essential Software +------------------------ + +Here is a list of software that you might want to have on your system. + + BOOTLOADERS + * efibootmgr + * grub + FILESYSTEMS + * e2fsprogs + * dosfstools + * ntfs-3g + NETWORKING + * dhcpcd + * wpa_supplicant + TEXT EDITORS + * nano + * vim + * neatvi + * nvi + * emacs + * emacs-nox (terminal-only version of emacs) + USER SHELLS + * bash + * zsh + * dash + * oksh + * rc + POSIX BASE UTILITIES + * busybox + * sbase + * coreutils + DOCUMENTATION + * carbs-docs + * man-pages + * man-pages-posix + +1.2.5 Obtaining the documentation (optional) +-------------------------------------------- + +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. + + Install the documentation. + $ cpt b carbs-docs && cpt i carbs-docs + + Install either texinfo or the info package. We will be installing standalone info + as it doesn't need perl. + $ cpt b info && cpt i info + + You can then run info and navigate through the documentation. + $ info carbslinux + +1.3 System Configuration +======================== + +After you have finished installing some extra packages, you can +configure your system to your liking. + +1.3.1 Configuring hostname (recommended) +---------------------------------------- + +You might want to add a hostname, especially in a networked environment. +Your hostname will default to 'carbslinux' unless you set this. + + $ echo your-hostname > /etc/hostname + +1.3.2 Setting up hosts file (optional) +-------------------------------------- + +You can edit your /etc/hosts file, which is the static lookup table for +host 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 + +1.4 Kernel +========== + +Kernel isn't managed under the main repositories, even though you could +package one for your personal use. Here is an example kernel package +(https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux), +which you will need to reconfigure for your specific setup if you want +to make use of it. + +1.4.1 Obtaining the kernel sources +---------------------------------- + +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. + + Download the kernel and extract it + $ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.7.6.tar.xz + $ tar xf linux-5.7.6.tar.xz + + Change directory into the kernel sources + $ cd linux-5.7.6 + +1.4.2 Installing dependencies +----------------------------- + +In order to compile the kernel you will need to install some +dependencies. You will need 'libelf' to compile the kernel. If you +want to configure using the menu interface you will also need 'ncurses'. + + The package manager asks to install if you are building more than one package, + so no need to run 'cpt i ...' + $ cpt b libelf ncurses + + In the vanilla kernel sources, you need perl to compile the kernel, +but it can be easily patched out. You will need to apply the following +patch. Patch was written by E5ten (https://github.com/E5ten). You will +need to obtain and apply the patch in the kernel source directory. + + $ wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch + $ patch -p1 < kernel-no-perl.patch + +1.4.3 Compiling the kernel +-------------------------- + +Next step is configuring and building the kernel. You can check +Gentoo's kernel configuration guide +(https://wiki.gentoo.org/wiki/Kernel/Configuration) to learn more about +the matter. Overall, Gentoo Wiki is a good place to learn about +configuration according to your hardware. The following will assume a +monolithic kernel. + + $ make menuconfig + $ make + $ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux + +1.5 Making your system bootable +=============================== + +In order to be able to boot your fresh system, wou will need an +init-daemon, init-scripts and a bootloader. The init daemon is already +provided by busybox, but you can optionally change it. + +1.5.1 Installing a bootloader +----------------------------- + +In the main repository, there is efibootmgr and grub to serve as +bootloaders. efibootmgr can be used as a standalone bootloader, or can +be used to install grub in a UEFI environment. efibootmgr is needed +unless you are using a device without UEFI support (or you really want +to use BIOS for a reason). + + GRUB BIOS installation + + $ cpt b grub && cpt i grub + $ grub-install --target=i386-pc /dev/sdX + $ grub-mkconfig -o /boot/grub/grub.cfg + + GRUB UEFI installation + + $ cpt b efibootmgr && cpt i efibootmgr + $ cpt b grub && cpt i grub + + $ grub-install --target=x86_64-efi \ + --efi-directory=esp \ + --bootloader-id=CarbsLinux + + $ grub-mkconfig -o /boot/grub/grub.cfg + +1.5.2 Installing init scripts +----------------------------- + +Only thing left to do is installing the init-scripts, and now you are +almost ready to boot your system! + + $ cpt b carbs-init && cpt i carbs-init + +1.5.3 Generating fstab +---------------------- + +You can now manually edit your fstab entry, or you can use the genfstab +tool. If you want to use the tool, exit the chroot and run the +following: + + $ wget https://github.com/cemkeylan/genfstab/raw/master/genfstab + $ chmod +x genfstab + $ ./genfstab -U /mnt >> /mnt/etc/fstab + +1.6 Post-installation +===================== + +The base installation is now complete, you can now fine tune your system +according to your needs. Rest of these instructions are completely +optional. + +1.6.1 Acquiring 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. + + $ git clone https://github.com/kisslinux/community $HOME/repos/kiss-community + $ export CPT_PATH=$CPT_PATH:$HOME/repos/kiss-community/community + + NOTE: There are lots of packages on the KISS community repository +that are also on Carbs Linux main repository. I would advise giving +lower priority to the KISS community repository as it may affect other +packages that you might install. diff --git a/src/news.xml b/src/news.xml index 7cf1650..319cae7 100644 --- a/src/news.xml +++ b/src/news.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/news.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Sep 10 2020 11:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> <item> <title>Sep 03 2020</title> <pubDate>Thu, 03 Sep 2020</pubDate> diff --git a/src/rss.xml b/src/rss.xml index cf2fe4b..1980970 100644 --- a/src/rss.xml +++ b/src/rss.xml @@ -9,7 +9,7 @@ <description>a simple linux distribution</description> <link>https://carbslinux.org</link> <atom:link href="https://carbslinux.org/rss.xml" rel="self" type="application/rss+xml" /> - <lastBuildDate>Thu Sep 10 2020 11:00</lastBuildDate> + <lastBuildDate>Mon Sep 14 2020 09:00</lastBuildDate> <item> <title>August 2020 News Post</title> <pubDate>Mon, 03 Aug 2020</pubDate> diff --git a/texidocs b/texidocs -Subproject 9cc50d7134d94db363f7b5d3e4a3a6368d1d9bc +Subproject 18c1c78d031cef9f4f8e50ff848c45737267acf |