Installing TLD Linux

The easiest way to install TLD Linux is to use Chroot Rescue / Installer. We recommend using CRI based on TLD Linux.

Storage preparations

Before you'll run installation you must prepare storage for your system. Start with partitioning your disks. If you have devices larger than 2TB be sure to choose utility that supports GPT partition tables and don't forget to create BIOS partition for GRUB (it must have at least 1 MB size and must be of type EF02). Without this partition GRUB will fail to install.

When your partitions are ready you may want to create RAID, LVM or LUKS volumes. Here are some examples:

RAID volumes

To create RAID1 array consisting of 2 SCSI partitions:

mdadm --create /dev/md0 --level=1 --raid-devices=2 /dev/sda1 /dev/sdb1

Partitions for RAID devices must be of type fd or FD00 (raid auto-detect).

To manually assemble previously created or existing RAID array:

mdadm --assemble /dev/md1 /dev/vda3 /dev/vdb3 /dev/vdc3

You may also try to automatically assemble all existing arrays if for some reason they were not assembled during boot:

mdadm --assemble --scan


To create new LVM volume you must first initialize physical volumes for your LVM configuration. You may do that by using command 'pvcreate'.

pvcreate /dev/md1

Next step is creation of LVM volume groups using command 'vgcreate':

vgcreate lvm_data /dev/md1

When volume group is defined you may create logical volumes in it. For example to create 5GB volume for root filesystem and 15 GB for /home:

lvcreate -L 5G -n root lvm_data
lvcreate -L 15G -n home lvm_data

If you have previously created or existing LVM config you may activate it manually (should be done auotmatically during boot):

vgchange -a y


To create encrypted LUKS volume you must use luksFormat command:

cryptsetup -v luksFormat /dev/md2

When prompted enter passphrase for your device. Warning! This will erase all data on selected device!

To access contents of LUKS volume you must use luksOpen command:

cryptsetup -v luksOpen /dev/md2 crypted_raid

If you will use encrypted LUKS volumes for your installation be sure to manually enter decryption password in proper field of /etc/crypttab in your installed system before rebooting or your system will not boot waiting for someone to type decryption password on local console. Note: CRI supports crypttab entries for LUKS volumes only!

Formatting and mounting filesystems

When your storage devices are ready you need to format them. For example:

mkswap /dev/lvm_data/swap
mkfs.ext4 /dev/md1
mkfs.ext4 /dev/lvm_data/root

Now please mount them on selected directory. For example:

mount /dev/lvm_data/root /chroot
mkdir /chroot/boot
mount /dev/md1 /chroot/boot

Network configuration

If you are going to install chroot from network or you want to install directly from one of TLD Linux mirrors you must configure network. You may easily do it using netconfig command. It is simple wizard that allows to configure ethernet and wireless interfaces. Additionally it supports creating VLAN, bonding and bridge interfaces.


To install TLD Linux using chroot please use this command:

crinstall /chroot/

This is fastest method of installation but you'll have to upgrade your system later.

Second options is to install directly from one of TLD Linux mirrors:

tldinstall /chroot/

This will download packages directly from chosen mirror. It will take longer but you'll have up to date version of TLD Linux installed. Note: this command is available in CRI based on TLD Linux.


Once installation is finished CRI will take care of all actions required to make your system bootable and you'll be presented with results of system initialization. If everything went fine you'll just need to umount all filesystems and reboot.

© TLD Linux