Debian Live Manual

The Debian Live Project

Unreleased Snapshot

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.

A copy of the GNU General Public License is available as /usr/share/common-licenses/GPL in the Debian GNU/Linux distribution or on the World Wide Web at the GNU web site. You can also obtain it by writing to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.

If you want to print this reference, this document is also available in Portable Document Format (PDF).

Sat, 01 May 2010 02:56:21 +0000

Table of Contents

1. About
1.1. About this manual
1.1.1. Terms
1.1.2. Authors
1.1.3. Contributing to this document
1.2. About the Debian Live Project
1.2.1. Motivation
1.2.2. Philosophy
1.2.3. Contact
2. Installation
2.1. Requirements
2.2. Installing live-helper
2.2.1. From the Debian repository
2.2.2. From source
2.2.3. From 'snapshots'
2.2.4. live-initramfs
3. The basics
3.1. What is a live system?
3.2. First steps: building an ISO image
3.2.1. Testing an ISO image with Qemu
3.2.2. Burning an ISO image to a physical medium
3.3. Building an USB/HDD image
3.3.1. Copying USB/HDD image to a USB stick
3.3.2. Testing a USB/HDD image with Qemu
3.3.3. Using the space left on a USB stick
3.4. Building a netboot image
3.5. Netboot testing HowTo
4. Overview of tools
4.1. live-helper
4.1.1. The lh config helper
4.1.2. The lh build helper
4.1.3. The lh clean helper
4.2. The live-initramfs package
5. Customization
5.1. Customising package installation
5.1.1. Package sources
5.1.2. Package installation
5.1.3. Installing additional packages
5.1.4. Installing modified or third-party packages
5.2. Customising contents
5.2.1. Includes
5.2.2. Hooks
5.2.3. Preseeding Debconf questions
5.2.4. Symlink conversion
5.3. Customising the bootup process
5.3.1. Kernel
5.3.2. Bootloaders
5.3.3. Splash screens
5.3.4. Memtest
5.3.5. Startup scripts
5.3.6. Cheat codes
5.4. Customising the binary image
5.4.1. ISO metadata
5.5. Using a newer kernel with Lenny
6. Common tasks
6.1. The Debian Installer
6.2. WiFi Connection
7. The Live environment
7.1. Swap space
7.2. Hostname
7.3. The Live user
7.4. Language
7.5. Persistence
7.5.1. Full persistence
7.5.2. Home automounting
7.5.3. Snapshots
7.5.4. Persistent SubText
7.5.5. Partial remastering
8. Frequently asked questions (FAQ)
9. Reporting bugs
9.1. Known issues
9.2. Rebuild from scratch
9.3. Use up-to-date packages
9.4. Collect information
9.5. Use the correct package to report the bug against
9.6. Do the research
9.7. Where to report bugs
10. Coding Style
10.1. Compatibility
10.2. Indenting
10.3. Wrapping
10.4. Variables
10.5. Miscellaneous
11. Procedures
11.1. Udeb Uploads
11.2. Major Releases
11.3. Point Releases
11.3.1. Point release announcement template
12. Resources and links
12.1. Links
12.2. Who is using Debian Live?
12.3. English sources related to debian live
12.4. German sources related to debian live
12.5. Spanish sources related to debian live
A. Configuration layout
B. Configuration files
B.1. The config/binary file
B.2. The config/bootstrap file
B.3. The config/chroot file
B.4. The config/common file
B.5. The config/source file