aboutsummaryrefslogtreecommitdiff
path: root/install.texi
diff options
context:
space:
mode:
authorCem Keylan <cem@ckyln.com>2020-09-21 22:14:48 +0300
committerCem Keylan <cem@ckyln.com>2020-09-21 22:14:48 +0300
commit73073b527fc4bf457a477fd08d7d5db94ec0c9ce (patch)
tree5e603f025ad21550c518da45b2db9caa3e7cde5c /install.texi
parent013282abdc4dc1263f58f3536425749b736aa972 (diff)
downloaddocs-73073b527fc4bf457a477fd08d7d5db94ec0c9ce.tar.gz
Add comment lines for the better visualizing of the file edited
Diffstat (limited to 'install.texi')
-rw-r--r--install.texi104
1 files changed, 98 insertions, 6 deletions
diff --git a/install.texi b/install.texi
index 37e8bb3..d05fa59 100644
--- a/install.texi
+++ b/install.texi
@@ -1,3 +1,8 @@
+@c This document is part of Carbs Linux Documentation.
+@c See the top.texi file for LICENSE information.
+
+@c -----------------------------------------------------------------------------
+
@node Installation
@chapter Installation
@@ -17,6 +22,9 @@ The instructions can also be found plaintext on
* Post-installation:: Acquiring more packages and repositories
@end menu
+
+@c -----------------------------------------------------------------------------
+
@node Preparing Environment
@section Preparing Environment
To install Carbs Linux, you will need a Live Linux ISO. For that purpose, you
@@ -24,6 +32,7 @@ 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:
+
@itemize
@item
tar
@@ -38,12 +47,15 @@ some form of base utilities (coreutils, sbase, busybox, etc.)
Rest of these instructions will assume that you have set all of these up, and
will continue on that point.
+
+@c -----------------------------------------------------------------------------
+
@subsection 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 @code{x86_64}
-with @code{i686}. We are setting this in a URL variable so that we don't have to
-write it every time.
+to obtain the rootfs. If you are using an i686 machine, replace the
+@code{x86_64} with @code{i686}. We are setting this in a URL variable so that we
+don't have to write it every time.
@example
$ URL=https://dl.carbslinux.org/releases/x86_64
@@ -53,17 +65,23 @@ $ wget $URL/carbs-rootfs.tar.xz
We can then check the integrity of the tarball and do a signature verification.
Even thought these are optional, they are highly recommended.
+
+@c -----------------------------------------------------------------------------
+
@subsection Check the integrity of the tarball (Recommended)
-All of the releases are saved in a single file named @file{sha256sums.txt}, but the
-latest release is saved on @file{carbs-rootfs.tar.xz.sha256}. You can acquire and
-verify the tarball.
+All of the releases are saved in a single file named @file{sha256sums.txt}, but
+the latest release is saved on @file{carbs-rootfs.tar.xz.sha256}. You can
+acquire and verify the tarball.
@example
$ wget $URL/carbs-rootfs.tar.xz.sha256
$ sha256sum -c carbs-rootfs.tar.xz.sha256
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Verify the signature
It is highly recommended to verify the signature of the tarball. You will need
@@ -75,6 +93,9 @@ $ gpg --recv-keys FF484BDFEFCEF8FF
$ gpg --verify carbs-rootfs.tar.xz.sig
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Extracting the tarball
You will need to extract the tarball to your desired location. For partitioning,
@@ -86,6 +107,9 @@ $ mount /dev/sdx1 /mnt
$ tar xf carbs-rootfs.tar.xz -C /mnt
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Obtain the chroot helper
You can obtain the @command{cpt-chroot} script in order to do a simple chroot into
@@ -96,6 +120,8 @@ $ wget https://dl.carbslinux.org/distfiles/cpt-chroot
$ chmod a+x cpt-chroot
@end example
+@c -----------------------------------------------------------------------------
+
@node Chroot
@section Chroot
@@ -105,6 +131,9 @@ Chroot into Carbs Linux!
$ ./cpt-chroot /mnt
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Setting up repositories
Newest tarballs do not come with repositories, so you will need to manually
@@ -123,6 +152,9 @@ you want. So go ahead and create that directory:
$ mkdir -p $HOME/repos
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsubsection Obtaining from rsync
Carbs Linux rsync repositories live in @url{rsync://carbslinux.org/repo}. In
@@ -132,6 +164,9 @@ order to obtain it, run the following:
$ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsubsection Obtaining from git
Carbs Linux git repositories can be found both from the main server and GitHub
@@ -148,6 +183,9 @@ Carbs Linux git repositories can be found both from the main server and GitHub
$ git clone git://git.carbslinux.org/repository $HOME/repos/carbs
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsubsection Making the package manager use the repositories
In your shell's configuration file, or in your @file{~/.profile} file, add the
@@ -162,6 +200,9 @@ CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community
export CPT_PATH
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Updating packages
It is good practice to make sure your system is up to date, especially before
@@ -172,6 +213,9 @@ need to update twice.
$ cpt update
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Installing packages
Since you are operating on a really small base, you might need to build and
@@ -184,6 +228,9 @@ $ cpt build package
$ cpt install package
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Essential Software
Here is a list of software that you might want to have on your system.
@@ -258,6 +305,9 @@ man-pages
man-pages-posix
@end itemize
+
+@c -----------------------------------------------------------------------------
+
@subsection Obtaining the documentation (optional)
All the documentation for Carbs Linux can be found on a single info manual to be
@@ -276,12 +326,18 @@ You can then run info and navigate through the documentation.
$ info carbslinux
@end example
+
+@c -----------------------------------------------------------------------------
+
@node System Configuration
@section System Configuration
After you have finished installing some extra packages, you can configure your
system to your liking.
+
+@c -----------------------------------------------------------------------------
+
@subsection Configuring hostname (recommended)
You might want to add a hostname, especially in a networked environment. Your
@@ -291,6 +347,9 @@ hostname will default to 'carbslinux' unless you set this.
$ echo your-hostname > /etc/hostname
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Setting up hosts file (optional)
You can edit your /etc/hosts file, which is the static lookup table for host
@@ -302,6 +361,9 @@ replace the 'localhost' part of these entries to your hostname.
::1 localhost.localdomain localhost ip6-localhost
@end example
+
+@c -----------------------------------------------------------------------------
+
@node Kernel
@section Kernel
@@ -310,6 +372,9 @@ one for your personal use. Here is an @url{https://github.com/cemkeylan/kiss-rep
which you will need to reconfigure for your specific setup if you want to make
use of it.
+
+@c -----------------------------------------------------------------------------
+
@subsection Obtaining the kernel sources
You can visit the https://kernel.org website to choose a kernel that you want
@@ -325,6 +390,9 @@ Change directory into the kernel sources
$ cd linux-5.7.6
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Installing dependencies
In order to compile the kernel you will need to install some dependencies. You
@@ -347,6 +415,9 @@ $ wget https://dl.carbslinux.org/distfiles/kernel-no-perl.patch
$ patch -p1 < kernel-no-perl.patch
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Compiling the kernel
Next step is configuring and building the kernel. You can check Gentoo's @url{https://wiki.gentoo.org/wiki/Kernel/Configuration, kernel configuration guide}
@@ -360,6 +431,9 @@ $ make
$ install -Dm755 $(make -s image_name) /boot/vmlinuz-linux
@end example
+
+@c -----------------------------------------------------------------------------
+
@node Making your system bootable
@section Making your system bootable
@@ -367,6 +441,9 @@ 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.
+
+@c -----------------------------------------------------------------------------
+
@subsection Installing a bootloader
In the main repository, there is efibootmgr and grub to serve as bootloaders.
@@ -395,6 +472,9 @@ $ grub-install --target=x86_64-efi \
$ grub-mkconfig -o /boot/grub/grub.cfg
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Installing init scripts
Only thing left to do is installing the init-scripts, and now you are almost
@@ -404,6 +484,9 @@ ready to boot your system!
$ cpt b carbs-init && cpt i carbs-init
@end example
+
+@c -----------------------------------------------------------------------------
+
@subsection Generating fstab
You can now manually edit your fstab entry, or you can use the genfstab tool.
@@ -415,12 +498,18 @@ $ chmod +x genfstab
$ ./genfstab -U /mnt >> /mnt/etc/fstab
@end example
+
+@c -----------------------------------------------------------------------------
+
@node Post-installation
@section 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.
+
+@c -----------------------------------------------------------------------------
+
@subsection Acquiring kiss repositories
While not 100% compatible with cpt, you can use kiss repositories in your
@@ -435,3 +524,6 @@ $ export CPT_PATH=$CPT_PATH:$HOME/repos/kiss-community/community
NOTE: There are lots of packages on the KISS community repository that are also
on Carbs Linux main repository. I would advise giving lower priority to the KISS
community repository as it may affect other packages that you might install.
+
+
+@c -----------------------------------------------------------------------------