1.2 Chroot

Chroot into Carbs Linux!

$ ./cpt-chroot /mnt

1.2.1 Setting up repositories

Newest tarballs do not come with repositories, so you will need to manually obtain them, and set your CPT_PATH environment variable. Carbs Linux repositories can either be obtained by git or rsync. While rsync repositories are overall faster and smaller, git offers the whole history of the repository and a means to manipulate your repository as you like it. If you want to obtain the git repository, you will need to install git itself.

The following guide will assume that you put the repositories into ~/repos/ directory, but you can put the repositories into any directory you want. So go ahead and create that directory:

$ mkdir -p $HOME/repos

1.2.1.1 Obtaining from rsync

Carbs Linux rsync repositories live in rsync://carbslinux.org/repo. In order to obtain it, run the following:

$ rsync -avc rsync://carbslinux.org/repo $HOME/repos/carbs

1.2.1.2 Obtaining from git

Carbs Linux git repositories can be found both from the main server and GitHub (mirror). Here are both their repository links. You can clone any of them.

• git://git.carbslinux.org/repository
• https://github.com/carbslinux/repository

$ git clone git://git.carbslinux.org/repository $HOME/repos/carbs

1.2.1.3 Making the package manager use the repositories

In your shell’s configuration file, or in your ~/.profile file, add the following lines:

export CPT_PATH=''
CPT_PATH=$CPT_PATH:$HOME/repos/carbs/core
CPT_PATH=$CPT_PATH:$HOME/repos/carbs/extra
CPT_PATH=$CPT_PATH:$HOME/repos/carbs/xorg
CPT_PATH=$CPT_PATH:$HOME/repos/carbs/community
export CPT_PATH

1.2.2 Updating packages

It is good practice to make sure your system is up to date, especially before building new packages. If there is an update for the package manager you will need to update twice.

$ cpt update

1.2.3 Installing packages

Since you are operating on a really small base, you might need to build and install new programs to extend the functionality of your system. In order to build and install packages new packages in Carbs, you need to execute the following. “Package” is not actually a package and is given as an example.

$ cpt build package
$ cpt install package

1.2.4 Essential Software

Here is a list of software that you might want to have on your system.

BOOTLOADERS

• efibootmgr
• grub

FILESYSTEMS

• e2fsprogs
• dosfstools
• ntfs-3g

NETWORKING

• dhcpcd
• wpa_supplicant

TEXT EDITORS

• nano
• vim
• neatvi
• nvi
• emacs
• emacs-nox (terminal-only version of emacs)

USER SHELLS

• bash
• zsh
• dash
• oksh
• rc

POSIX BASE UTILITIES

• busybox
• sbase
• coreutils

DOCUMENTATION

• carbs-docs
• man-pages
• man-pages-posix

1.2.5 Obtaining the documentation (optional)

All the documentation for Carbs Linux can be found on a single info manual to be viewed offline. You can obtain texinfo or the info (standalone) package in order to view the documentation.

Install the documentation.
$ cpt b carbs-docs && cpt i carbs-docs

Install either texinfo or the info package. We will be installing standalone info
as it doesn't need perl.
$ cpt b info && cpt i info

You can then run info and navigate through the documentation.
$ info carbslinux