Go to file
johndah4x0r 12ab0b2b01 Update README 2017-07-25 14:24:06 +02:00
DOC updated 2013-01-15 06:01:26 -06:00
bootfiles default name "linux" will be nicer 2017-05-18 03:52:52 -05:00
initramfs copy all user-compiled (dkms) kernel modules to initrd too 2017-05-23 04:16:43 -04:00
tools suggest packages to be installed for debian to be able to recompile isolinux 2017-05-18 03:54:05 -05:00
.config default name "linux" will be nicer 2017-05-18 03:52:52 -05:00
README Update README 2017-07-25 14:24:06 +02:00
TODO Uncompress kernel modules. Thanks to glensc for suggestion 2013-03-24 04:43:29 -05:00
bootinfo.txt documentation updates 2012-11-20 06:34:59 -06:00
build support genisoimage as well as mkisofs 2017-05-18 03:53:31 -05:00
livekitlib refresh devices manually 2017-05-23 06:43:23 -04:00

README

Linux Live Kit Improved.
This set of scripts will help you to 
build your own Live Kit distro. This project is based on 
the original Linux Live Kit. <http://linux-live.org>

NOTE: 
  Make sure to extract and use it on a POSIX-compatible filesystem,
  since it creates some (sym)links and such.

Some information you want to know:

Make sure to extract and use it on a POSIX-compatible filesystem,
since it will create symlinks and such.
+ Store Linux Live Kit in a directory which is not going to be included
  in your live distro, else it would be copied to it. Best practice is to
  make a directory such as /tmp/a and put all the files there.
  NOTE:
    Make sure to extract and use it on a POSIX-compatible filesystem,
    since it will create symlinks and such.
    
+ Before you start building your Kit, edit the ./.config file
  Most importantly change the LIVEKITNAME variable.

+ Make sure you are pointing to the right kernel. If in doubt, change the path in ./.config
  Your kernel must support squashfs and aufs, or else you will get an error 
  both while building, and when you actually boot the Live Kit.
  
  PROTIP:
    Debian Jessie's kernel has both supported out-of-the-box.
    You might consider using Debian Jessie as a base, but it's not required.

+ You may also wish to replace boot background in ./bootfiles/bootlogo.png
  and edit and/or tweak syslinux.cfg to fit your needs. 
  
  NOTE:
    When editing the configuration file, make sure to keep all paths 
    pointing to /boot/, since it will be replaced to /LIVEKITNAME/boot/ 
    during the build session.

+ Linux Live Kit comes with precompiled static binaries in ./initramfs
  directory. Those may be outdated but will work. You may replace them
  by your own statically linked binaries, if you know how to compile them.

+ If you want to boot your Live Kit from a CD, you need to recompile
  syslinux.bin/isolinux.bin else it won't be able to boot your Live Kit 
  from directory "/LIVEKITNAME". There is a script prepared for you which 
  will handle all of the building. Simply go to directory ./tools/ and run 
  update-isolinux.bin, it will rebuild ./bootfiles/isolinux.bin automatically 
  by downloading SysLinux sources, patching them using your actual LIVEKITNAME and
  recompiling. This step is not needed if you plan only need the ZIP archive version.

+ If you have tmpfs mounted on /tmp, make sure you have enough (or maybe even 
  a lot of) RAM, since Live Kit will store lots of data to the target. 
  If you don't have enough (or even went out of) RAM, make sure 
  that /tmp is a regular on-disk directory.

+ When you're ready run the ./build script to create your Live Kit
  - it will create ISO and ZIP files for you in /tmp
  - make sure you have enough free space in /tmp to handle it

+ You will need the following packages to be installed:
  - squashfs-tools
  - genisoimage or mkisofs
  - zip