From ec7e9e3183492bcd18d06c02b90930f6a837c6b5 Mon Sep 17 00:00:00 2001 From: Cem Keylan Date: Mon, 27 Jul 2020 01:21:06 +0300 Subject: site update --- docs/404.html | 45 +++-- docs/blog/20200128.html | 45 +++-- docs/blog/20200406.html | 45 +++-- docs/blog/20200410.html | 45 +++-- docs/blog/20200508.html | 45 +++-- docs/blog/20200528.html | 45 +++-- docs/blog/20200617.html | 45 +++-- docs/blog/index.html | 45 +++-- docs/contributing.html | 45 +++-- docs/docs/README | 19 ++ docs/docs/install.html | 503 ++++++++++++++++++++++++++++++++++++++++++++++++ docs/docs/install.txt | 475 +++++++++++++++++++++++++++++++++++++++++++++ docs/index.html | 63 +++--- docs/index.txt | 22 +-- docs/mailing-lists.html | 45 +++-- docs/news.html | 52 +++-- docs/news.txt | 7 + docs/news.xml | 26 ++- docs/people.html | 45 +++-- docs/rss.xml | 14 +- 20 files changed, 1369 insertions(+), 307 deletions(-) create mode 100644 docs/docs/README create mode 100644 docs/docs/install.html create mode 100644 docs/docs/install.txt (limited to 'docs') diff --git a/docs/404.html b/docs/404.html index fa8e64d..52e291c 100644 --- a/docs/404.html +++ b/docs/404.html @@ -1,26 +1,29 @@ - - -404 | Carbs Linux - - - - - - -

+ + + 404 | Carbs Linux + + + + + + + +

404

Requested page not found.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200128.html b/docs/blog/20200128.html index aa5a708..8a30c56 100644 --- a/docs/blog/20200128.html +++ b/docs/blog/20200128.html @@ -1,21 +1,23 @@ - - -Switching to New Website | Carbs Linux - - - - - - -

+ + + Switching to New Website | Carbs Linux + + + + + + + +

Switching to New Website

Date: Jan 28 2020

@@ -36,8 +38,9 @@ the site with a combination of mk (instead of make), rc, and POSIX sh. I am not yet exactly familiar with rc, but I will replace the shell scripts when I feel like I can.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200406.html b/docs/blog/20200406.html index d8d0952..ba77659 100644 --- a/docs/blog/20200406.html +++ b/docs/blog/20200406.html @@ -1,21 +1,23 @@ - - -Roadmap for Carbs | Carbs Linux - - - - - - -

+ + + Roadmap for Carbs | Carbs Linux + + + + + + + +

Roadmap for Carbs

It has been a busy week. There are lots of changes in @@ -76,8 +78,9 @@ manager. The now empty repository, can be found View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200410.html b/docs/blog/20200410.html index 0125687..b7c07ac 100644 --- a/docs/blog/20200410.html +++ b/docs/blog/20200410.html @@ -1,21 +1,23 @@ - - -Outsource Repository Concept | Carbs Linux - - - - - - -

+ + + Outsource Repository Concept | Carbs Linux + + + + + + + +

Outsource Repository Concept

In April 3rd, I have added submodule support for Carbs @@ -39,8 +41,9 @@ Firefox and its dependencies have been purged from the main repository, but can be found on it.

https://github.com/CarbsLinux/outsource

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200508.html b/docs/blog/20200508.html index 49da3e3..fe8e624 100644 --- a/docs/blog/20200508.html +++ b/docs/blog/20200508.html @@ -1,21 +1,23 @@ - - -The Relation of Carbs and KISS | Carbs Linux - - - - - - -

+ + + The Relation of Carbs and KISS | Carbs Linux + + + + + + + +

The Relation of Carbs and KISS

Date: May 08 2020

@@ -135,8 +137,9 @@ to thoroughly give an explanation.

Cheers, Cem

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200528.html b/docs/blog/20200528.html index 2abe18d..11ca8ba 100644 --- a/docs/blog/20200528.html +++ b/docs/blog/20200528.html @@ -1,21 +1,23 @@ - - -kiss 2.0.0 and overall changes | Carbs Linux - - - - - - -

+ + + kiss 2.0.0 and overall changes | Carbs Linux + + + + + + + +

kiss 2.0.0 and overall changes

Carbs Linux kiss version 2.0.0 has been released which introduces @@ -59,8 +61,9 @@ by others interested on the matter as well.

Cheers, Cem

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/20200617.html b/docs/blog/20200617.html index d4de442..69fd722 100644 --- a/docs/blog/20200617.html +++ b/docs/blog/20200617.html @@ -1,21 +1,23 @@ - - -June Newspost | Carbs Linux - - - - - - -

+ + + June Newspost | Carbs Linux + + + + + + + +

June Newspost

This will be an active month for Carbs as major changes to the base and the @@ -93,8 +95,9 @@ little outdated which will also receive some important updates.

I am thinking of releasing an ISO image in order to provide a standardized environment for installation along with installation helper tools in the spirit of arch-install-scripts. Let’s see how that’s going to play out.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/blog/index.html b/docs/blog/index.html index dfba995..75ea51b 100644 --- a/docs/blog/index.html +++ b/docs/blog/index.html @@ -1,21 +1,23 @@ - - -Blog Index | Carbs Linux - - - - - - -

+ + + Blog Index | Carbs Linux + + + + + + + +

Blog Index

This is the Carbs Linux Blog Index. You can find every post here. RSS Feed

@@ -29,8 +31,9 @@

Jan 28 2020 - Switching to New Website

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/contributing.html b/docs/contributing.html index 90ea5ee..27d2da0 100644 --- a/docs/contributing.html +++ b/docs/contributing.html @@ -1,21 +1,23 @@ - - -Contribute to the Carbs Linux Project | Carbs Linux - - - - - - -

+ + + Contribute to the Carbs Linux Project | Carbs Linux + + + + + + + +

Contribute to the Carbs Linux Project

This is a small project made possible by volunteers. There are @@ -27,8 +29,9 @@ ways you can help this project stay alive.

Contribute to the wiki

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/docs/README b/docs/docs/README new file mode 100644 index 0000000..68ca07d --- /dev/null +++ b/docs/docs/README @@ -0,0 +1,19 @@ +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 new file mode 100644 index 0000000..3b37dc1 --- /dev/null +++ b/docs/docs/install.html @@ -0,0 +1,503 @@ + + + + Installation Instructions | Carbs Linux + + + + + + + +

+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
+

+ View Page Source +

+ + + + diff --git a/docs/docs/install.txt b/docs/docs/install.txt new file mode 100644 index 0000000..d068a67 --- /dev/null +++ b/docs/docs/install.txt @@ -0,0 +1,475 @@ +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/index.html b/docs/index.html index 2639ee6..44a4192 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,29 +1,31 @@ - - -index | Carbs Linux - - - - - - -

+ + + index | Carbs Linux + + + + + + + +

Carbs Linux is an in-development Linux® distribution with a suckless mindset. The base system consists of only the necessary programs to create a Linux distribution.

Package Manager

Carbs Linux uses its own fork of the kiss package manager which is an -extremely flexible package manager.

Carbs Linux uses its own package manager Carbs Packaging Tools, a POSIX shell +package manager forked from KISS with the tool-based approach of xbps.

Small base

@@ -73,6 +75,13 @@ other system supervision technique along with your own init scripts.

RSS Feed | See all news

Jul 27 2020

+ +

Carbs Linux’s fork of the kiss package manager has been renamed to +Carbs Packaging Tools due to huge amount of changes. Your latest kiss +update will handle the bootstrapping. You will need to rename your KISS-* +variables to CPT-*

Jun 17 2020

A new rootfs tarball including the changes to the core is released and can be @@ -93,15 +102,9 @@ been released. It can be found on the patch to your kernel sources.

- -

Apr 27 2020

- -

A new rootfs tarball has been released! You can -see it on https://dl.carbslinux.org/releases!

- -

EDIT: A new bug fix release has been made.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/index.txt b/docs/index.txt index 6635bc7..46ae09e 100644 --- a/docs/index.txt +++ b/docs/index.txt @@ -5,8 +5,8 @@ distribution. Package Manager -------------------------------------------------------------------------------- -Carbs Linux uses its own fork of the [kiss package manager] which is an -extremely flexible package manager. +Carbs Linux uses its own package manager [Carbs Packaging Tools], a POSIX shell +package manager forked from KISS with the tool-based approach of xbps. Small base @@ -43,7 +43,7 @@ other system supervision technique along with your own init scripts. [carbs-init]: https://github.com/CarbsLinux/repository/tree/master/core/carbs-init -[kiss package manager]: https://github.com/CarbsLinux/kiss +[Carbs Packaging Tools]: https://github.com/CarbsLinux/cpt Links -------------------------------------------------------------------------------- @@ -60,6 +60,14 @@ News [RSS Feed](/news.xml) | [See all news](/news.html) +Jul 27 2020 +-------------------------------------------------------------------------------- + +Carbs Linux's fork of the `kiss` package manager has been renamed to +`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` +update will handle the bootstrapping. You will need to rename your `KISS-*` +variables to `CPT-*` + Jun 17 2020 -------------------------------------------------------------------------------- @@ -90,11 +98,3 @@ with GCC 10.1. This issue can be resolved by applying this [patch] to your kernel sources. [patch]: https://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git/patch/?id=f670269a42bfdd2c83a1118cc3d1b475547eac22 - -Apr 27 2020 --------------------------------------------------------------------------------- - -A new rootfs tarball has been released! You can -see it on ! - -**EDIT:** A new bug fix release has been made. diff --git a/docs/mailing-lists.html b/docs/mailing-lists.html index c74f9ae..d1e04f9 100644 --- a/docs/mailing-lists.html +++ b/docs/mailing-lists.html @@ -1,21 +1,23 @@ - - -Mailing Lists | Carbs Linux - - - - - - -

+ + + Mailing Lists | Carbs Linux + + + + + + + +

Mailing Lists

We have mailing lists set up at sourcehut. You can subscribe to the mailing @@ -25,8 +27,9 @@ list by sending an empty mail to

You can also see the archives.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/news.html b/docs/news.html index 9ad57c9..5f182df 100644 --- a/docs/news.html +++ b/docs/news.html @@ -1,21 +1,30 @@ - - -news | Carbs Linux - - - - - - -

+ + + Jul 27 2020 | Carbs Linux + + + + + + + +

Jul 27 2020

+ +

Jun 17 2020

A new rootfs tarball including the changes to the core is released and can be @@ -218,8 +227,9 @@ This is for adding standalone runit/runit-init to the repositories.

Dec 10 2019

First alpha release was made. See the downloads page.

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/news.txt b/docs/news.txt index 91b1ce8..f297a81 100644 --- a/docs/news.txt +++ b/docs/news.txt @@ -1,3 +1,10 @@ +Jul 27 2020 +-------------------------------------------------------------------------------- + +Carbs Linux's fork of the `kiss` package manager has been renamed to +`Carbs Packaging Tools` due to huge amount of changes. Your latest `kiss` +update will handle the bootstrapping. You will need to rename your `KISS-*` +variables to `CPT-*` Jun 17 2020 -------------------------------------------------------------------------------- diff --git a/docs/news.xml b/docs/news.xml index 4ca82dd..f16599b 100644 --- a/docs/news.xml +++ b/docs/news.xml @@ -4,12 +4,24 @@ xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" > - -Carbs Linux -a simple busybox linux distribution -https://carbslinux.org - -Jun Sat 2020 20:00 + + Carbs Linux + a simple linux distribution + https://carbslinux.org + + Sun Jul 26 2020 22:00 + +Jul 27 2020 +Mon, 27 Jul 2020 +Cem Keylan +https://carbslinux.org/index.html +<h2>Jul 27 2020</h2> + +<p>Carbs Linux’s fork of the <code>kiss</code> package manager has been renamed to +<code>Carbs Packaging Tools</code> due to huge amount of changes. Your latest <code>kiss</code> +update will handle the bootstrapping. You will need to rename your <code>KISS-*</code> +variables to <code>CPT-*</code></p> + Jun 17 2020 Wed, 17 Jun 2020 @@ -322,5 +334,5 @@ This is for adding standalone runit/runit-init to the repositories.</p> - + diff --git a/docs/people.html b/docs/people.html index dac1b57..3195e2b 100644 --- a/docs/people.html +++ b/docs/people.html @@ -1,29 +1,32 @@ - - -People | Carbs Linux - - - - - - -

+ + + People | Carbs Linux + + + + + + + +

People

Cem Keylan - Founder cem@ckyln.com

-View Page Source

- - - + View Page Source +

+ + + diff --git a/docs/rss.xml b/docs/rss.xml index 5788d02..e10b7b5 100644 --- a/docs/rss.xml +++ b/docs/rss.xml @@ -4,12 +4,12 @@ xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:sy="http://purl.org/rss/1.0/modules/syndication/" > - -Carbs Linux -a simple busybox linux distribution -https://carbslinux.org - -Jun Sat 2020 20:00 + + Carbs Linux + a simple linux distribution + https://carbslinux.org + + Sun Jul 26 2020 22:00 June Newspost Wed, 17 Jun 2020 @@ -388,5 +388,5 @@ and POSIX sh. I am not yet exactly familiar with rc, but I will replace the shell scripts when I feel like I can.</p> - + -- cgit v1.2.3