aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/docs.html2
-rw-r--r--docs/docs.txt1
-rw-r--r--docs/docs/README19
-rw-r--r--docs/docs/install.html503
-rw-r--r--docs/docs/install.txt475
-rw-r--r--docs/news.xml2
-rw-r--r--docs/rss.xml2
7 files changed, 2 insertions, 1002 deletions
diff --git a/docs/docs.html b/docs/docs.html
index 89993f1..0e0515f 100644
--- a/docs/docs.html
+++ b/docs/docs.html
@@ -31,8 +31,6 @@ your system for viewing offline:</p>
</code></pre>
<h2>Documentation Index</h2>
-
-<p><a href="/docs/install.html">Installation Instructions</a></p>
<a href="/docs.txt">View Page Source</a>
<div class="border"></div>
<p class=footer>Linux® is a registered trademark of Linus Torvalds</p>
diff --git a/docs/docs.txt b/docs/docs.txt
index fd2000e..a481cf0 100644
--- a/docs/docs.txt
+++ b/docs/docs.txt
@@ -13,4 +13,3 @@ your system for viewing offline:
Documentation Index
--------------------------------------------------------------------------------
-[Installation Instructions](/docs/install.html)
diff --git a/docs/docs/README b/docs/docs/README
deleted file mode 100644
index 68ca07d..0000000
--- a/docs/docs/README
+++ /dev/null
@@ -1,19 +0,0 @@
-CARBS LINUX DOCUMENTATION
-================================================================================
-
-This is the source of offline documentation for Carbs Linux. It is a part of the
-'core' repository and can be obtained by installing it with kiss.
-
- +--------------------------------------------------------------------------+
- | $ kiss b carbs-docs |
- | $ kiss i carbs-docs |
- +--------------------------------------------------------------------------+
-
-This documentation isn't complete yet, you can help by expanding it.
-
-
-[1.0] Document structure
---------------------------------------------------------------------------------
-
-Documents are categorized in directory structures which provide information on
-a certain subject. \ No newline at end of file
diff --git a/docs/docs/install.html b/docs/docs/install.html
deleted file mode 100644
index 34ef03f..0000000
--- a/docs/docs/install.html
+++ /dev/null
@@ -1,503 +0,0 @@
-<!DOCTYPE HTML>
-<html lan=en>
- <head>
- <title>Installation Instructions | 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/install.html'>installation</a>
- </nav>
- </div><div class="border"></div>
-<pre>
-Installation Instructions
-================================================================================
-
-This post will guide you step-by-set in order to install Carbs Linux. You can
-obtain these instructions for offline use, the plaintext version can be found on
-<a href=https://carbslinux.org/docs/install.txt>https://carbslinux.org/docs/install.txt</a>
-
-
-TABLE OF CONTENTS
---------------------------------------------------------------------------------
-
-- Downloading and getting ready to chroot <a href=#1.0>[1.0]</a>
- - Download <a href=#1.1>[1.1]</a>
- - Check the integrity of the tarball (Recommended) <a href=#1.2>[1.2]</a>
- - Verify the signature <a href=#1.3>[1.3]</a>
- - Extracting the tarball <a href=#1.4>[1.4]</a>
- - Obtain the chroot helper <a href=#1.5>[1.5]</a>
-- Chroot <a href=#2.0>[2.0]</a>
- - Updating packages (optional) <a href=#2.1>[2.1]</a>
- - Installing packages <a href=#2.2>[2.2]</a>
- - Essential software <a href=#2.3>[2.3]</a>
- - Obtaining the documentation (optional) <a href=#2.4>[2.4]</a>
-- System Configuration <a href=#3.0>[3.0]</a>
- - Configuring hostname (recommended) <a href=#3.1>[3.1]</a>
- - Setting up the hosts file (optional) <a href=#3.2>[3.2]</a>
- - Generating fstab <a href=#3.3>[3.3]</a>
-- Kernel <a href=#4.0>[4.0]</a>
- - Obtaining the kernel sources. <a href=#4.1>[4.1]</a>
- - Installing dependencies <a href=#4.2>[4.2]</a>
- - Compiling the kernel <a href=#4.3>[4.3]</a>
-- Making your system bootable <a href=#5.0>[5.0]</a>
- - Installing a bootloader <a href=#5.1>[5.1]</a>
- - Installing init scripts <a href=#5.2>[5.2]</a>
-- Post-installation <a href=#6.0>[6.0]</a>
- - Acquiring kiss repositories <a href=#6.1>[6.1]</a>
-
-
-
-<span id=1.0><a href=#1.0>[1.0]</a></span> Downloading and getting ready to chroot
---------------------------------------------------------------------------------
-
-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 (or curl)
-- xz
-- some form of base utilities (coreutils, sbase, busybox, etc.)
-
-Rest of the instructions assume that you have set all of these up, and will
-continue on that point.
-
-
-<span id=1.1><a href=#1.1>[1.1]</a></span> 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'.
-
- +--------------------------------------------------------------------------+
- | |
- | $ wget <a href=https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz>https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz</a> |
- | |
- +--------------------------------------------------------------------------+
-
-We can then check the integrity of the tarball and do a signature verification.
-Even though these are optional, they are highly recommended.
-
-
-<span id=1.2><a href=#1.2>[1.2]</a></span> Check the integrity of the tarball (Recommended)
---------------------------------------------------------------------------------
-
-All of the releases are saved in a single file named 'sha256sums.txt'. You can
-either verify manually, or you can run the following for a single step
-verification.
-
- +-----------------------------------------------------------------------------+
- | |
- | $ wget <a href=https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256>https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256</a> |
- | |
- | $ sha256sum -c carbs-rootfs.tar.xz.sha256 |
- | |
- | This should produce the following (or a similar) output: |
- | carbs-rootfs.tar.xz: OK |
- | |
- +-----------------------------------------------------------------------------+
-
-
-<span id=1.3><a href=#1.3>[1.3]</a></span> Verify the signature
---------------------------------------------------------------------------------
-
-It is highly recommended to verify the signature of the tarball. You will need
-GPG for this.
-
- +--------------------------------------------------------------------------+
- | |
- | $ wget <a href=https://carbslinux.org/releases/carbs-rootfs.tar.xz.sig>https://carbslinux.org/releases/carbs-rootfs.tar.xz.sig</a> |
- | |
- | $ gpg --recv-keys FF484BDFEFCEF8FF |
- | |
- | $ gpg --verify carbs-rootfs.tar.xz.sig |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=1.4><a href=#1.4>[1.4]</a></span> Extracting the tarball
---------------------------------------------------------------------------------
-
-You will need to extract the tarball to your desired location. For partitioning,
-you can follow this guide<a href=#1>[1]</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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=1.5><a href=#1.5>[1.5]</a></span> 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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=2.0><a href=#2.0>[2.0]</a></span> Chroot
---------------------------------------------------------------------------------
-
-Chroot into Carbs Linux!
-
- +--------------------------------------------------------------------------+
- | |
- | $ ./cpt-chroot /mnt |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=2.1><a href=#2.1>[2.1]</a></span> Updating packages (optional)
---------------------------------------------------------------------------------
-
-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 |
- | |
- +--------------------------------------------------------------------------+
- | |
- | If the package manager is updated, run the same command again. |
- | $ cpt update |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=2.2><a href=#2.2>[2.2]</a></span> 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.
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt build package |
- | $ cpt install package |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=2.3><a href=#2.3>[2.3]</a></span> 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<a href=#2>[2]</a>
- - wpa_supplicant
- TEXT EDITORS
- - nano
- - vim
- - neatvi
- - nvi
- - emacs
- - emacs-nox (terminal-only version of emacs)
- - mg (micro gnuemacs)
- USER SHELLS
- - bash
- - dash
- - zsh
- - 9base (rc shell)
- DEVICE MANAGEMENT
- - eudev
- COREUTILS
- - sbase
- DOCUMENTATION
- - carbs-docs <a href=#2.4>[2.4]</a>
- - man-pages
- - man-pages-posix
- OTHER
- - git
-
-
-<span id=2.4><a href=#2.4>[2.4]</a></span> Obtaining the documentation (optional)
---------------------------------------------------------------------------------
-
-All the documentation for Carbs Linux (including this installation manual) can
-be obtained to be viewed offline.
-
- +--------------------------------------------------------------------------+
- | |
- | Install the documentation. |
- | $ cpt b carbs-docs && cpt i carbs-docs |
- | |
- | 'docs' tool can be used in order to crawl through the documentation. |
- | |
- | Following command can be used in order to view this installation guide |
- | through a pager. |
- | |
- | $ docs install |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=3.0><a href=#3.0>[3.0]</a></span> System Configuration
---------------------------------------------------------------------------------
-
-After you have finished installing some extra packages, you can configure your
-system to your liking.
-
-
-<span id=3.1><a href=#3.1>[3.1]</a></span> 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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=3.2><a href=#3.2>[3.2]</a></span> Setting up the 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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=3.3><a href=#3.3>[3.3]</a></span> Generating fstab
---------------------------------------------------------------------------------
-
-You can use this POSIX sh variant for genfstab
-
-
-<span id=4.0><a href=#4.0>[4.0]</a></span> 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, which you will
-need to reconfigure for your specific setup if you want to make use of it<a href=#3>[3]</a>.
-
-
-<span id=4.1><a href=#4.1>[4.1]</a></span> 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 |
- | |
- +--------------------------------------------------------------------------+
-
-<span id=4.2><a href=#4.2>[4.2]</a></span> Installing dependencies
---------------------------------------------------------------------------------
-
-In order to compile the kernel you will need to install some dependencies.
-
- +--------------------------------------------------------------------------+
- | |
- | You will need libelf to compile the kernel |
- | |
- | $ cpt b libelf && cpt i libelf |
- | |
- +--------------------------------------------------------------------------+
- | |
- | In order to configure the kernel with a user interface, you will need |
- | ncurses to be installed on your system. |
- | |
- | $ cpt b ncurses && cpt i 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=#4>[4]</a>.
-
- +--------------------------------------------------------------------------+
- | |
- | Obtain the patch by downloading it. |
- | |
- | $ wget <a href=https://dl.carbslinux.org/distfiles/kernel-no-perl.patch>https://dl.carbslinux.org/distfiles/kernel-no-perl.patch</a> |
- | |
- | Apply the patch. |
- | |
- | $ patch -p1 < kernel-no-perl.patch |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=4.3><a href=#4.3>[4.3]</a></span> Compiling the kernel
---------------------------------------------------------------------------------
-
-Next step is configuring and building the kernel. You can check Gentoo's kernel
-configuration guide<a href=#5>[5]</a> to learn more about the matter. Overall, Gentoo Wiki is a
-good place to learn about configuration according to your hardware.
-
- +--------------------------------------------------------------------------+
- | Configure and build the kernel |
- +--------------------------------------------------------------------------+
- | |
- | $ make menuconfig |
- | $ make |
- | |
- +--------------------------------------------------------------------------+
- | Install the kernel |
- +--------------------------------------------------------------------------+
- | |
- | $ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=5.0><a href=#5.0>[5.0]</a></span> 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.
-
-
-<span id=5.1><a href=#5.1>[5.1]</a></span> 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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=5.2><a href=#5.2>[5.2]</a></span> Installing init scripts
---------------------------------------------------------------------------------
-
-Only thing left to do is installing the init-scripts, and now you are ready to
-boot your system!
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt b carbs-init && cpt i carbs-init |
- | |
- +--------------------------------------------------------------------------+
-
-
-<span id=6.0><a href=#6.0>[6.0]</a></span> 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.
-
-
-<span id=6.1><a href=#6.1>[6.1]</a></span> Acquiring kiss repositories
---------------------------------------------------------------------------------
-
-Most kiss repositories can only be obtained through git, but it isn't installed
-by default. You'll need to install it:
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt b git && cpt i git |
- | |
- +--------------------------------------------------------------------------+
-
-
-After installing git, you can clone a repository, and add it to your path:
-
- +--------------------------------------------------------------------------+
- | KISS Community Repository |
- +--------------------------------------------------------------------------+
- | |
- | $ git clone <a href=https://github.com/kisslinux/community>https://github.com/kisslinux/community</a> |
- | $ export CPT_PATH=$CPT_PATH:$PWD/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. |
- | |
- +--------------------------------------------------------------------------+
-
-
-You can also lookup other repositories on GitHub, by searching the 'cpt-repo'
-tag, or looking it up on the KISS Wiki page for repositories<a href=#6>[6]</a>.
-
-
-Footnotes
---------------------------------------------------------------------------------
-<span id=1><a href=#1>[1]</a></span>: <a href=https://wiki.archlinux.org/index.php/Partitioning>https://wiki.archlinux.org/index.php/Partitioning</a>
-<span id=2><a href=#2>[2]</a></span>: busybox also provides udhcpc which can be used to configure dynamic IP
-<span id=3><a href=#3>[3]</a></span>: <a href=https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux>https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux</a>
-<span id=4><a href=#4>[4]</a></span>: <a href=https://github.com/E5ten>https://github.com/E5ten</a>
-<span id=5><a href=#5>[5]</a></span>: <a href=https://wiki.gentoo.org/wiki/Kernel/Configuration>https://wiki.gentoo.org/wiki/Kernel/Configuration</a>
-<span id=6><a href=#6>[6]</a></span>: <a href=https://k1ss.org/wiki/community/repositories>https://k1ss.org/wiki/community/repositories</a>
-</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
deleted file mode 100644
index d068a67..0000000
--- a/docs/docs/install.txt
+++ /dev/null
@@ -1,475 +0,0 @@
-Installation Instructions
-================================================================================
-
-This post will guide you step-by-set in order to install Carbs Linux. You can
-obtain these instructions for offline use, the plaintext version can be found on
-https://carbslinux.org/docs/install.txt
-
-
-TABLE OF CONTENTS
---------------------------------------------------------------------------------
-
-- Downloading and getting ready to chroot [1.0]
- - Download [1.1]
- - Check the integrity of the tarball (Recommended) [1.2]
- - Verify the signature [1.3]
- - Extracting the tarball [1.4]
- - Obtain the chroot helper [1.5]
-- Chroot [2.0]
- - Updating packages (optional) [2.1]
- - Installing packages [2.2]
- - Essential software [2.3]
- - Obtaining the documentation (optional) [2.4]
-- System Configuration [3.0]
- - Configuring hostname (recommended) [3.1]
- - Setting up the hosts file (optional) [3.2]
- - Generating fstab [3.3]
-- Kernel [4.0]
- - Obtaining the kernel sources. [4.1]
- - Installing dependencies [4.2]
- - Compiling the kernel [4.3]
-- Making your system bootable [5.0]
- - Installing a bootloader [5.1]
- - Installing init scripts [5.2]
-- Post-installation [6.0]
- - Acquiring kiss repositories [6.1]
-
-
-
-[1.0] Downloading and getting ready to chroot
---------------------------------------------------------------------------------
-
-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 (or curl)
-- xz
-- some form of base utilities (coreutils, sbase, busybox, etc.)
-
-Rest of the instructions assume that you have set all of these up, and will
-continue on that point.
-
-
-[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'.
-
- +--------------------------------------------------------------------------+
- | |
- | $ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz |
- | |
- +--------------------------------------------------------------------------+
-
-We can then check the integrity of the tarball and do a signature verification.
-Even though these are optional, they are highly recommended.
-
-
-[1.2] Check the integrity of the tarball (Recommended)
---------------------------------------------------------------------------------
-
-All of the releases are saved in a single file named 'sha256sums.txt'. You can
-either verify manually, or you can run the following for a single step
-verification.
-
- +-----------------------------------------------------------------------------+
- | |
- | $ wget https://dl.carbslinux.org/releases/x86_64/carbs-rootfs.tar.xz.sha256 |
- | |
- | $ sha256sum -c carbs-rootfs.tar.xz.sha256 |
- | |
- | This should produce the following (or a similar) output: |
- | carbs-rootfs.tar.xz: OK |
- | |
- +-----------------------------------------------------------------------------+
-
-
-[1.3] Verify the signature
---------------------------------------------------------------------------------
-
-It is highly recommended to verify the signature of the tarball. You will need
-GPG for this.
-
- +--------------------------------------------------------------------------+
- | |
- | $ wget https://carbslinux.org/releases/carbs-rootfs.tar.xz.sig |
- | |
- | $ gpg --recv-keys FF484BDFEFCEF8FF |
- | |
- | $ gpg --verify carbs-rootfs.tar.xz.sig |
- | |
- +--------------------------------------------------------------------------+
-
-
-[1.4] Extracting the tarball
---------------------------------------------------------------------------------
-
-You will need to extract the tarball to your desired location. For partitioning,
-you can follow this guide[1]. 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.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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-[2.0] Chroot
---------------------------------------------------------------------------------
-
-Chroot into Carbs Linux!
-
- +--------------------------------------------------------------------------+
- | |
- | $ ./cpt-chroot /mnt |
- | |
- +--------------------------------------------------------------------------+
-
-
-[2.1] Updating packages (optional)
---------------------------------------------------------------------------------
-
-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 |
- | |
- +--------------------------------------------------------------------------+
- | |
- | If the package manager is updated, run the same command again. |
- | $ cpt update |
- | |
- +--------------------------------------------------------------------------+
-
-
-[2.2] 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.
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt build package |
- | $ cpt install package |
- | |
- +--------------------------------------------------------------------------+
-
-
-[2.3] 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[2]
- - wpa_supplicant
- TEXT EDITORS
- - nano
- - vim
- - neatvi
- - nvi
- - emacs
- - emacs-nox (terminal-only version of emacs)
- - mg (micro gnuemacs)
- USER SHELLS
- - bash
- - dash
- - zsh
- - 9base (rc shell)
- DEVICE MANAGEMENT
- - eudev
- COREUTILS
- - sbase
- DOCUMENTATION
- - carbs-docs [2.4]
- - man-pages
- - man-pages-posix
- OTHER
- - git
-
-
-[2.4] Obtaining the documentation (optional)
---------------------------------------------------------------------------------
-
-All the documentation for Carbs Linux (including this installation manual) can
-be obtained to be viewed offline.
-
- +--------------------------------------------------------------------------+
- | |
- | Install the documentation. |
- | $ cpt b carbs-docs && cpt i carbs-docs |
- | |
- | 'docs' tool can be used in order to crawl through the documentation. |
- | |
- | Following command can be used in order to view this installation guide |
- | through a pager. |
- | |
- | $ docs install |
- | |
- +--------------------------------------------------------------------------+
-
-
-[3.0] System Configuration
---------------------------------------------------------------------------------
-
-After you have finished installing some extra packages, you can configure your
-system to your liking.
-
-
-[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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-[3.2] Setting up the 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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-[3.3] Generating fstab
---------------------------------------------------------------------------------
-
-You can use this POSIX sh variant for genfstab
-
-
-[4.0] 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, which you will
-need to reconfigure for your specific setup if you want to make use of it[3].
-
-
-[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 |
- | |
- +--------------------------------------------------------------------------+
-
-[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 |
- | |
- | $ cpt b libelf && cpt i libelf |
- | |
- +--------------------------------------------------------------------------+
- | |
- | In order to configure the kernel with a user interface, you will need |
- | ncurses to be installed on your system. |
- | |
- | $ cpt b ncurses && cpt i 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[4].
-
- +--------------------------------------------------------------------------+
- | |
- | Obtain the patch by downloading it. |
- | |
- | $ wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch |
- | |
- | Apply the patch. |
- | |
- | $ patch -p1 < kernel-no-perl.patch |
- | |
- +--------------------------------------------------------------------------+
-
-
-[4.3] Compiling the kernel
---------------------------------------------------------------------------------
-
-Next step is configuring and building the kernel. You can check Gentoo's kernel
-configuration guide[5] to learn more about the matter. Overall, Gentoo Wiki is a
-good place to learn about configuration according to your hardware.
-
- +--------------------------------------------------------------------------+
- | Configure and build the kernel |
- +--------------------------------------------------------------------------+
- | |
- | $ make menuconfig |
- | $ make |
- | |
- +--------------------------------------------------------------------------+
- | Install the kernel |
- +--------------------------------------------------------------------------+
- | |
- | $ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux |
- | |
- +--------------------------------------------------------------------------+
-
-
-[5.0] 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.
-
-
-[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 |
- | |
- +--------------------------------------------------------------------------+
-
-
-[5.2] Installing init scripts
---------------------------------------------------------------------------------
-
-Only thing left to do is installing the init-scripts, and now you are ready to
-boot your system!
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt b carbs-init && cpt i carbs-init |
- | |
- +--------------------------------------------------------------------------+
-
-
-[6.0] 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.
-
-
-[6.1] Acquiring kiss repositories
---------------------------------------------------------------------------------
-
-Most kiss repositories can only be obtained through git, but it isn't installed
-by default. You'll need to install it:
-
- +--------------------------------------------------------------------------+
- | |
- | $ cpt b git && cpt i git |
- | |
- +--------------------------------------------------------------------------+
-
-
-After installing git, you can clone a repository, and add it to your path:
-
- +--------------------------------------------------------------------------+
- | KISS Community Repository |
- +--------------------------------------------------------------------------+
- | |
- | $ git clone https://github.com/kisslinux/community |
- | $ export CPT_PATH=$CPT_PATH:$PWD/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. |
- | |
- +--------------------------------------------------------------------------+
-
-
-You can also lookup other repositories on GitHub, by searching the 'cpt-repo'
-tag, or looking it up on the KISS Wiki page for repositories[6].
-
-
-Footnotes
---------------------------------------------------------------------------------
-[1]: https://wiki.archlinux.org/index.php/Partitioning
-[2]: busybox also provides udhcpc which can be used to configure dynamic IP
-[3]: https://github.com/cemkeylan/kiss-repository/tree/master/personal/linux
-[4]: https://github.com/E5ten
-[5]: https://wiki.gentoo.org/wiki/Kernel/Configuration
-[6]: https://k1ss.org/wiki/community/repositories
diff --git a/docs/news.xml b/docs/news.xml
index 2323a56..0ad7f24 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 03 2020 08:00</lastBuildDate>
+ <lastBuildDate>Wed Sep 09 2020 14: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 37ac90c..07708a0 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 03 2020 08:00</lastBuildDate>
+ <lastBuildDate>Wed Sep 09 2020 14:00</lastBuildDate>
<item>
<title>August 2020 News Post</title>
<pubDate>Mon, 03 Aug 2020</pubDate>