Live Systems Manual




Building live system images has very few system requirements:

●  Superuser (root) access

●  An up-to-date version of live-build

●  A POSIX-compliant shell, such as bash or dash

●  debootstrap

●  Linux 2.6 or newer.

Note that using Debian or a Debian-derived distribution is not required - live-build will run on almost any distribution with the above requirements.

Installing live-build

You can install live-build in a number of different ways:

●  From the Debian repository

●  From source

●  From snapshots

If you are using Debian, the recommended way is to install live-build via the Debian repository.

From the Debian repository

Simply install live-build like any other package:

 # apt-get install live-build  

From source

live-build is developed using the Git version control system. On Debian based systems, this is provided by the git package. To check out the latest code, execute:

 $ git clone git://live-systems.org/git/live-build.git  

You can build and install your own Debian package by executing:

 $ cd live-build
 $ dpkg-buildpackage -b -uc -us
 $ cd ..  

Now install whichever of the freshly built .deb files you were interested in, e.g.

 # dpkg -i live-build_4.0-1_all.deb  

You can also install live-build directly to your system by executing:

 # make install  

and uninstall it with:

 # make uninstall  

From 'snapshots'

If you do not wish to build or install live-build from source, you can use snapshots. These are built automatically from the latest version in Git and are available on http://live-systems.org/debian/.

Installing live-boot and live-config

Note: You do not need to install live-boot or live-config on your system to create customized live systems. However, doing so will do no harm and is useful for reference purposes. If you only want the documentation, you may now install the live-boot-doc and live-config-doc packages separately.

From the Debian repository

Both live-boot and live-config are available from the Debian repository as per Installing live-build.

From source

To use the latest source from git, you can follow the process below. Please ensure you are familiar with the terms mentioned in Terms.

●  Checkout the live-boot and live-config sources

 $ git clone git://live-systems.org/git/live-boot.git
 $ git clone git://live-systems.org/git/live-config.git  

Consult the live-boot and live-config man pages for details on customizing if that is your reason for building these packages from source.

●  Build live-boot and live-config .deb files

You must build either on your target distribution or in a chroot containing your target platform: this means if your target is ${testing} then you should build against ${testing}.

Use a personal builder such as pbuilder or sbuild if you need to build live-boot for a target distribution that differs from your build system. For example, for ${testing} live images, build live-boot in a ${testing} chroot. If your target distribution happens to match your build system distribution, you may build directly on the build system using dpkg-buildpackage (provided by the dpkg-dev package):

 $ cd live-boot
 $ dpkg-buildpackage -b -uc -us
 $ cd ../live-config
 $ dpkg-buildpackage -b -uc -us  

●  Use applicable generated .deb files

As live-boot and live-config are installed by live-build system, installing the packages in the host system is not sufficient: you should treat the generated .deb files like any other custom packages. Since your purpose for building from source is likely to test new things over the short term before the official release, follow Installing modified or third-party packages to temporarily include the relevant files in your configuration. In particular, notice that both packages are divided into a generic part, a documentation part and one or more back-ends. Include the generic part, only one back-end matching your configuration, and optionally the documentation. Assuming you are building a live image in the current directory and have generated all .deb files for a single version of both packages in the directory above, these bash commands would copy all of the relevant packages including default back-ends:

 $ cp ../live-boot{_,-initramfs-tools,-doc}*.deb  config/packages.chroot/
 $ cp ../live-config{_,-sysvinit,-doc}*.deb  config/packages.chroot/  

From 'snapshots'

You can let live-build automatically use the latest snapshots of live-boot and live-config by configuring the package repository on live-systems.org as a third-party repository in your live-build configuration directory.

License: This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

The complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.

≅ SiSU Spine ፨ (object numbering & object search)

(web 1993, object numbering 1997, object search 2002 ...) 2024