Berryboot

Adding your own Linux distributions to Berryboot
(for advanced users)

Instead of choosing a Linux distribution from the list, it is also possible to add your own Linux distribution. Berryboot accepts image files in SquashFS format.

Converting a rootfs tarball
To convert a rootfs, such as ubuntu-alip, execute on a normal Linux desktop computer as root:

 mkdir temp tar -C temp/ -xjf my-rootfs.tar.bz2 mksquashfs temp my_image_for_berryboot.img -comp lzo

Converting a disk image
Some operating system images are distributed as disk images containing two partitions. A FAT partition with the boot loader and kernel files, and a second ext4 partition with everything else. We are interested in the second partition.

With a regular Linux desktop computer that has kpartx and mksquashfs installed, you can convert the second partition to SquashFS like this:

 $ sudo kpartx -av image_you_want_to_convert.img add map loop0p1 (252:5): 0 117187 linear /dev/loop0 1 add map loop0p2 (252:6): 0 3493888 linear /dev/loop0 118784 $ sudo mount /dev/mapper/loop0p2 /mnt $ sudo mksquashfs /mnt my_image_for_berryboot.img -comp lzo -e lib/modules $ sudo umount /mnt $ sudo kpartx -d image_you_want_to_convert.img

We are excluding /lib/modules from the image, because the kernel modules shipped with Berryboot are used instead, and shared with all distributions.

Caveats when converting images
Notes:


 * Berryboot is incompatible with images that use /lib -> /usr/lib symlink constructs such as Fedora 18. To work around this, move /usr/lib to /lib, and make a symlink /usr/lib -> /lib instead. Same with /sbin
 * It is not necessary to add entries to /etc/fstab. Berryboot takes care of mounting the root filesystem.

Adding the image to Berryboot

 * You can copy my_image_for_berryboot.img to the /images folder on the Berryboot microSD card.
 * Or you put the image file on USB stick, go to the Berryboot menu editor, hold down your mouse button over "add OS" and select "from USB stick" there.