diff options
Diffstat (limited to 'docs/wiki/install.html')
| -rw-r--r-- | docs/wiki/install.html | 337 |
1 files changed, 0 insertions, 337 deletions
diff --git a/docs/wiki/install.html b/docs/wiki/install.html deleted file mode 100644 index e9c882b..0000000 --- a/docs/wiki/install.html +++ /dev/null @@ -1,337 +0,0 @@ -<!DOCTYPE HTML> -<html lan="en"> -<head> -<title>Install | Carbs Linux</title> -<link rel="stylesheet" href="/assets/style.css"> -<meta charset="utf-8"> -<meta name="Description" content="Carbs Linux - a simple busybox linux distribution"> -<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"> -</head> -<p class=header><strong>Carbs Linux - a simple busybox linux distribution</strong></p> -<div class="header"><nav> -<a href='/'>index</a> -<a href='https://github.com/CarbsLinux'>github</a> -<a href='//dl.carbslinux.org'>downloads</a> -<a href='/blog'>blog</a> -<a href='/wiki'>wiki</a> -<a href='/wiki/install.html'>installation</a> -</nav></div><div class="border"></div> -<h1>Installation Instructions</h1> - -<p>This post will guide you step-by-step in order to install -Carbs Linux. It is not complete yet.</p> - -<h2>Downloading and Getting Ready to Chroot</h2> - -<p>Installing Carbs Linux is the same as installing most -rootfs distributions, such as Gentoo, or Void Linux.</p> - -<h3>Requirements</h3> - -<p>You simply need a Live Linux ISO. Gentoo would be the best -as programs you will require will be already there. Get the -ISO, boot it and set up your network.</p> - -<p><strong>Required Programs:</strong></p> - -<ul> -<li>tar</li> -<li>wget</li> -<li>xz</li> -</ul> - - -<p>Rest of the instructions assume that you have set all of these -up, and will continue on.</p> - -<h3>Download</h3> - -<p>First, we need to download the rootfs tarball. In your terminal -type</p> - -<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz -</code></pre> - -<h3>Check the integrity of the tarball</h3> - -<p>While optional, it is highly recommended to check the integrity -of the tarball.</p> - -<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sha256sum -$ sha256sum -c carbs-rootfs-20191210.tar.xz.sha256sum -</code></pre> - -<h3>Check the signatures</h3> - -<p>While optional, it is highly recommended to check the signature -of the tarball</p> - -<pre><code>$ wget https://carbslinux.org/releases/carbs-rootfs-20191210.tar.xz.sig - -Import the public key of release@carbslinux.org - -$ gpg --recv-keys FF484BDFEFCEF8FF - -$ gpg --verify carbs-rootfs-20191210.tar.xz.sig -</code></pre> - -<h3>Download Kiss Linux Chroot Helper</h3> - -<pre><code>$ wget https://dl.getkiss.org/kiss-chroot - -Make the script executable - -$ chmod +x kiss-chroot -</code></pre> - -<h3>Extract the rootfs tarball</h3> - -<p>You need to extract the tarball to your mounted partition</p> - -<pre><code>$ tar xvpf carbs-rootfs-20191210.tar.xz -C /mnt -</code></pre> - -<h2>Chroot</h2> - -<p>Chroot into Carbs Linux</p> - -<pre><code>$ ./kiss-chroot /mnt -</code></pre> - -<h3>Enable repository signing (Highly Recommended)</h3> - -<p>This step is optional, but very highly recommended -(I cannot stress out the amount I am recommending this). -This ensures you are receiving updates from Carbs Linux -and not some other source.</p> - -<p><strong>Install GnuPG</strong></p> - -<p>It is also a great time to learn how to use your new -package manager, KISS! You simply build and install -the package</p> - -<pre><code>$ kiss build gnupg1 -$ kiss install gnupg1 -</code></pre> - -<p><strong>Import my key</strong></p> - -<pre><code>Import my public key (cem@ckyln.com) - -$ gpg --recv-key 4356EE08A364CE09 - -Create a .gnupg directory if it doesn't exist - -$ mkdir -p /root/.gnupg - -Trust my public key - -$ echo trusted-key 0x4356ee08a364ce09 >> /root/.gnupg/gpg.conf -</code></pre> - -<p><strong>Enable signature verification</strong></p> - -<p>Git has a built in signature verification feature. -You can go to the repository directory and enable it</p> - -<pre><code>$ cd /var/db/kiss/repo -$ git config merge.verifySignatures true -</code></pre> - -<h3>Installing Important Tools</h3> - -<p>Since Carbs gives you one of the most minimal base, -you might need to apply some add-ons to your system.</p> - -<p><strong>Update packages</strong></p> - -<p>It might be a good idea to update your packages before -installing new packages. This ensure compatibility.</p> - -<pre><code>$ kiss update -</code></pre> - -<p><strong>Filesystems</strong></p> - -<p>Currently, e2fsprogs and dosfstools are supported, -as they are the most-used filesystems.</p> - -<pre><code>Support for ext2, ext3, and ex4 - -$ kiss build e2fsprogs -$ kiss install e2fsprogs - -Support for dosfstools - -$ kiss build dosfstools -$ kiss install dosfstools -</code></pre> - -<p><strong>Device management</strong></p> - -<pre><code>$ kiss build eudev -$ kiss install eudev -</code></pre> - -<p><strong>Wireless</strong></p> - -<p><strong>wpa_supplicant</strong></p> - -<pre><code>$ kiss build wpa_supplicant -$ kiss install wpa_supplicant -</code></pre> - -<p><strong>eiwd (WIP)</strong></p> - -<pre><code>$ kiss build eiwd -$ kiss install eiwd -</code></pre> - -<p><strong>dhcpcd</strong></p> - -<pre><code>$ kiss build dhcpcd -$ kiss install dhcpcd -</code></pre> - -<p><strong>Shells</strong></p> - -<p>Carbs Linux comes preinstalled with busybox ash, but other shells -can be found on the repository</p> - -<pre><code>Install bash - -$ kiss build bash -$ kiss install bash - -Install zsh - -$ kiss build zsh -$ kiss install zsh - -Install Plan9 rc-shell - -$ kiss build 9base -$ kiss install 9base -</code></pre> - -<h3>Install the Kernel</h3> - -<p><strong>IMPORTANT:</strong> If you have GCC 10.x on your system, you need to apply -this <a href="https://dl.carbslinux.org/distfiles/linux-gcc-10-bootfix.patch">patch</a> to your kernel sources. Otherwise your kernel will panic -during the boot stage.</p> - -<p>Next step is installing the kernel, which might sound as a challenge -you should download and extract the kernel tarball first.</p> - -<pre><code>$ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.tar.xz - -Let's move the sources to /usr/src - -$ mv linux-5.5.tar.xz /usr/src -$ tar xf linux-5.5.tar.xz -$ cd linux-5.5 -</code></pre> - -<p><strong>Configure the Kernel</strong></p> - -<p>You can check <a href="https://wiki.gentoo.org/wiki/Kernel/Configuration">https://wiki.gentoo.org/wiki/Kernel/Configuration</a> -to learn more about kernel configuration. Overall, <a href="https://wiki.gentoo.org">Gentoo Wiki</a> -is a good place to learn about kernel configuration related to -your hardware.</p> - -<p><strong>Build and install the kernel</strong></p> - -<p>The rest of it is simple, build the kernel with -<code>make</code> and install it with <code>make install</code></p> - -<h3>Bootloader</h3> - -<p>The default bootloader is GRUB (GRand Unified Bootloader).</p> - -<p>Build and install GRUB</p> - -<pre><code>$ kiss b grub -$ kiss i grub - -Install efibootmgr as well if your -system requires it - -$ kiss b efibootmgr -$ kiss i efibootmgr -</code></pre> - -<p><strong>Setup GRUB</strong></p> - -<pre><code>For BIOS: -$ grub-install --target=i386-pc /dev/sdX - -For UEFI: -$ grub-install --target=x86_64-efi --efi-directory=esp --bootloader-id=CarbsLinux - -$ grub-mkconfig -o /boot/grub/grub.cfg -</code></pre> - -<h3>Install init</h3> - -<p>Currently, default init for Carbs Linux is <code>sinit</code>, but -busybox-init is also supported. You can also change this yourself.</p> - -<p>To install init, you have to</p> - -<pre><code>$ kiss b sinit -$ kiss i sinit -</code></pre> - -<p>This will also fetch busybox-init as its dependency.</p> - -<h3>Enabling other repositories</h3> - -<p>There are other repositories out there that might be of your -interest. The Official Repositories come with community and testing -repositories that are not enabled by default. You could also want to -add the Kiss Linux community repository, or someone’s personal kiss -repository.</p> - -<p><strong>Obtaining repositories</strong></p> - -<p>Obtaining a repository is as simple as a git clone. You can do it -with Cem’s personal repository as an example, but any other repository -will be the same.</p> - -<pre><code># Clone the repository to your desired location -# Optionally add "--depth 1" to save precious disk space - -$ git clone --depth 1 git://git.ckyln.com/kiss-repository /var/db/kiss/cem-repository -</code></pre> - -<p>That’s it, you have obtained a new repository!</p> - -<p><strong>Adding a repository to your KISS_PATH</strong></p> - -<p>Now that we have obtained Cem’s repository, we can add it to our KISS_PATH!</p> - -<p>We need to edit <code>/etc/profile.d/kiss_path.sh</code> for this, but you -can also change your KISS_PATH from your shellrc.</p> - -<p>Add the full path to the repository, in this case -<code>/var/db/kiss/cem-repository/cem</code> to the variable -and add a <code>:</code> before/after it.</p> - -<p>It must be looking like this.</p> - -<pre><code>export KISS_PATH=/var/db/kiss/repo/core:/var/db/kiss/repo/extra:/var/db/kiss/repo/xorg:/var/db/kiss/cem-repository/cem -</code></pre> - -<p>Update your shell variables by doing <code>. /etc/profile.d/kiss_path.sh</code> so you can -immediately access the repository packages</p> - -<h2>More</h2> - -<p>You should now be able to boot into you Carbs Linux installation. -To learn more, you can visit the <a href="//carbslinux.org/wiki">wiki</a></p> -<a href="/wiki/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> |