<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title> Live Systems Manual </title> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta name="dc.title" content="Live Systems Manual" /> <meta name="dc.author" content="Live Systems Project <debian-live@lists.debian.org>" /> <meta name="dc.publisher" content="Live Systems Project <debian-live@lists.debian.org>" /> <meta name="dc.date" content="2015-09-22" /> <meta name="dc.rights" content="Copyright: Copyright (C) 2006-2015 Live Systems Project \\ 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." /> <meta name="generator" content="SiSU 7.2.1_pre_rel of 2019w35/4 (2019-09-05) (n*x and Ruby!)" /> <link rel="generator" href="http://www.sisudoc.org/" /> <link rel="shortcut icon" href="../_sisu/image/rb7.ico" /> <link href="../_sisu/css/html.css" rel="stylesheet"> <link href="../../_sisu/css/html.css" rel="stylesheet"> </head> <body lang="en"> <a name="top" id="top"></a> <table summary="table of contents segment navigation band" id="toc" width="100%" bgcolor="#ffffff"> <tr><td width="20%"> <table summary="home button / home information" border="0" cellpadding="3" cellspacing="0"> <tr><td align="left" bgcolor="#ffffff"> <p class="tiny_left"><a href="http://debian-live.alioth.debian.org/manual" target="_top"> Live manual </a></p> <p class="tiny_left"><a href="http://debian-live.alioth.debian.org" target="_top"> Live Systems </a></p> </td></tr> </table> </td> <td width="75%" align="center"> <table summary="segment navigation available documents types: toc,doc,pdf,concordance" border="0" cellpadding="3" cellspacing="0"> <tr> <td align="center" bgcolor="#ffffff"> </tr></table> </td> <td width="5%" align="right"> <a href="about-manual.en.html" target="_top" alt="->"> <img border="0" width="22" height="22" src="../../_sisu/image_sys/arrow_next_red.png" alt="next >>" /></a> </td></tr> </table> <p> <table summary="segment instrument cover band, title, author, location" width="100%" border="0" cellpadding="8" align="center"> <tr><td align="center"> <p class="centerbold">Live Systems Manual </p> <p class="centerbold">Live Systems Project <debian-live@lists.debian.org> </p> </td></tr> </table> <h1 class="toc"> Live Systems Manual </h1> <h1 class="toc"> About </h1> <h1 class="toc"> About this manual </h1> <h4 class="toc"> <a href="about-manual.en.html" target="_top"> 1. About this manual </a> </h4> <h5 class="toc"> <a href="about-manual.en.html#8"> 1.1 For the impatient </a> </h5> <h5 class="toc"> <a href="about-manual.en.html#12"> 1.2 Terms </a> </h5> <h5 class="toc"> <a href="about-manual.en.html#29"> 1.3 Authors </a> </h5> <h5 class="toc"> <a href="about-manual.en.html#44"> 1.4 Contributing to this document </a> </h5> <h6 class="toc"> <a href="about-manual.en.html#46"> 1.4.1 Applying changes </a> </h6> <h6 class="toc"> <a href="about-manual.en.html#60"> 1.4.2 Translation </a> </h6> <h1 class="toc"> About the Live Systems Project </h1> <h4 class="toc"> <a href="about-project.en.html" target="_top"> 2. About the Live Systems Project </a> </h4> <h5 class="toc"> <a href="about-project.en.html#75"> 2.1 Motivation </a> </h5> <h6 class="toc"> <a href="about-project.en.html#76"> 2.1.1 What is wrong with current live systems </a> </h6> <h6 class="toc"> <a href="about-project.en.html#86"> 2.1.2 Why create our own live system? </a> </h6> <h5 class="toc"> <a href="about-project.en.html#94"> 2.2 Philosophy </a> </h5> <h6 class="toc"> <a href="about-project.en.html#95"> 2.2.1 Only unchanged packages from Debian "main" </a> </h6> <h6 class="toc"> <a href="about-project.en.html#99"> 2.2.2 No package configuration of the live system </a> </h6> <h5 class="toc"> <a href="about-project.en.html#103"> 2.3 Contact </a> </h5> <h1 class="toc"> User </h1> <h1 class="toc"> Installation </h1> <h4 class="toc"> <a href="installation.en.html" target="_top"> 3. Installation </a> </h4> <h5 class="toc"> <a href="installation.en.html#110"> 3.1 Requirements </a> </h5> <h5 class="toc"> <a href="installation.en.html#118"> 3.2 Installing live-build </a> </h5> <h6 class="toc"> <a href="installation.en.html#124"> 3.2.1 From the Debian repository </a> </h6> <h6 class="toc"> <a href="installation.en.html#127"> 3.2.2 From source </a> </h6> <h6 class="toc"> <a href="installation.en.html#138"> 3.2.3 From 'snapshots' </a> </h6> <h5 class="toc"> <a href="installation.en.html#140"> 3.3 Installing live-boot and live-config </a> </h5> <h6 class="toc"> <a href="installation.en.html#142"> 3.3.1 From the Debian repository </a> </h6> <h6 class="toc"> <a href="installation.en.html#144"> 3.3.2 From source </a> </h6> <h6 class="toc"> <a href="installation.en.html#156"> 3.3.3 From 'snapshots' </a> </h6> <h1 class="toc"> The basics </h1> <h4 class="toc"> <a href="the-basics.en.html" target="_top"> 4. The basics </a> </h4> <h5 class="toc"> <a href="the-basics.en.html#163"> 4.1 What is a live system? </a> </h5> <h5 class="toc"> <a href="the-basics.en.html#171"> 4.2 Downloading prebuilt images </a> </h5> <h5 class="toc"> <a href="the-basics.en.html#173"> 4.3 Using the web live image builder </a> </h5> <h6 class="toc"> <a href="the-basics.en.html#175"> 4.3.1 Web builder usage and caveats </a> </h6> <h5 class="toc"> <a href="the-basics.en.html#179"> 4.4 First steps: building an ISO hybrid image </a> </h5> <h5 class="toc"> <a href="the-basics.en.html#190"> 4.5 Using an ISO hybrid live image </a> </h5> <h6 class="toc"> <a href="the-basics.en.html#192"> 4.5.1 Burning an ISO image to a physical medium </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#195"> 4.5.2 Copying an ISO hybrid image to a USB stick </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#200"> 4.5.3 Using the space left on a USB stick </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#207"> 4.5.4 Booting the live medium </a> </h6> <h5 class="toc"> <a href="the-basics.en.html#211"> 4.6 Using a virtual machine for testing </a> </h5> <h6 class="toc"> <a href="the-basics.en.html#218"> 4.6.1 Testing an ISO image with QEMU </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#225"> 4.6.2 Testing an ISO image with VirtualBox </a> </h6> <h5 class="toc"> <a href="the-basics.en.html#233"> 4.7 Building and using an HDD image </a> </h5> <h5 class="toc"> <a href="the-basics.en.html#245"> 4.8 Building a netboot image </a> </h5> <h6 class="toc"> <a href="the-basics.en.html#258"> 4.8.1 DHCP server </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#262"> 4.8.2 TFTP server </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#267"> 4.8.3 NFS server </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#275"> 4.8.4 Netboot testing HowTo </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#278"> 4.8.5 Qemu </a> </h6> <h5 class="toc"> <a href="the-basics.en.html#284"> 4.9 Webbooting </a> </h5> <h6 class="toc"> <a href="the-basics.en.html#286"> 4.9.1 Getting the webboot files </a> </h6> <h6 class="toc"> <a href="the-basics.en.html#292"> 4.9.2 Booting webboot images </a> </h6> <h1 class="toc"> Overview of tools </h1> <h4 class="toc"> <a href="overview-of-tools.en.html" target="_top"> 5. Overview of tools </a> </h4> <h5 class="toc"> <a href="overview-of-tools.en.html#300"> 5.1 The live-build package </a> </h5> <h6 class="toc"> <a href="overview-of-tools.en.html#310"> 5.1.1 The <tt>lb config</tt> command </a> </h6> <h6 class="toc"> <a href="overview-of-tools.en.html#320"> 5.1.2 The <tt>lb build</tt> command </a> </h6> <h6 class="toc"> <a href="overview-of-tools.en.html#322"> 5.1.3 The <tt>lb clean</tt> command </a> </h6> <h5 class="toc"> <a href="overview-of-tools.en.html#324"> 5.2 The live-boot package </a> </h5> <h5 class="toc"> <a href="overview-of-tools.en.html#328"> 5.3 The live-config package </a> </h5> <h1 class="toc"> Managing a configuration </h1> <h4 class="toc"> <a href="managing-a-configuration.en.html" target="_top"> 6. Managing a configuration </a> </h4> <h5 class="toc"> <a href="managing-a-configuration.en.html#333"> 6.1 Dealing with configuration changes </a> </h5> <h6 class="toc"> <a href="managing-a-configuration.en.html#335"> 6.1.1 Why use auto scripts? What do they do? </a> </h6> <h6 class="toc"> <a href="managing-a-configuration.en.html#338"> 6.1.2 Use example auto scripts </a> </h6> <h5 class="toc"> <a href="managing-a-configuration.en.html#345"> 6.2 Clone a configuration published via Git </a> </h5> <h1 class="toc"> Customizing contents </h1> <h4 class="toc"> <a href="customization-overview.en.html" target="_top"> 7. Customization overview </a> </h4> <h5 class="toc"> <a href="customization-overview.en.html#359"> 7.1 Build time vs. boot time configuration </a> </h5> <h5 class="toc"> <a href="customization-overview.en.html#362"> 7.2 Stages of the build </a> </h5> <h5 class="toc"> <a href="customization-overview.en.html#365"> 7.3 Supplement lb config with files </a> </h5> <h5 class="toc"> <a href="customization-overview.en.html#367"> 7.4 Customization tasks </a> </h5> <h1 class="toc"> Customizing package installation </h1> <h4 class="toc"> <a href="customizing-package-installation.en.html" target="_top"> 8. Customizing package installation </a> </h4> <h5 class="toc"> <a href="customizing-package-installation.en.html#372"> 8.1 Package sources </a> </h5> <h6 class="toc"> <a href="customizing-package-installation.en.html#373"> 8.1.1 Distribution, archive areas and mode </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#380"> 8.1.2 Distribution mirrors </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#382"> 8.1.3 Distribution mirrors used at build time </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#386"> 8.1.4 Distribution mirrors used at run time </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#389"> 8.1.5 Additional repositories </a> </h6> <h5 class="toc"> <a href="customizing-package-installation.en.html#397"> 8.2 Choosing packages to install </a> </h5> <h6 class="toc"> <a href="customizing-package-installation.en.html#399"> 8.2.1 Package lists </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#402"> 8.2.2 Using metapackages </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#410"> 8.2.3 Local package lists </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#414"> 8.2.4 Local binary package lists </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#416"> 8.2.5 Generated package lists </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#420"> 8.2.6 Using conditionals inside package lists </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#429"> 8.2.7 Removing packages at install time </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#431"> 8.2.8 Desktop and language tasks </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#436"> 8.2.9 Kernel flavour and version </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#441"> 8.2.10 Custom kernels </a> </h6> <h5 class="toc"> <a href="customizing-package-installation.en.html#449"> 8.3 Installing modified or third-party packages </a> </h5> <h6 class="toc"> <a href="customizing-package-installation.en.html#456"> 8.3.1 Using <tt>packages.chroot</tt> to install custom packages </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#463"> 8.3.2 Using an APT repository to install custom packages </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#466"> 8.3.3 Custom packages and APT </a> </h6> <h5 class="toc"> <a href="customizing-package-installation.en.html#469"> 8.4 Configuring APT at build time </a> </h5> <h6 class="toc"> <a href="customizing-package-installation.en.html#471"> 8.4.1 Choosing apt or aptitude </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#475"> 8.4.2 Using a proxy with APT </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#478"> 8.4.3 Tweaking APT to save space </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#487"> 8.4.4 Passing options to apt or aptitude </a> </h6> <h6 class="toc"> <a href="customizing-package-installation.en.html#492"> 8.4.5 APT pinning </a> </h6> <h1 class="toc"> Customizing contents </h1> <h4 class="toc"> <a href="customizing-contents.en.html" target="_top"> 9. Customizing contents </a> </h4> <h5 class="toc"> <a href="customizing-contents.en.html#501"> 9.1 Includes </a> </h5> <h6 class="toc"> <a href="customizing-contents.en.html#506"> 9.1.1 Live/chroot local includes </a> </h6> <h6 class="toc"> <a href="customizing-contents.en.html#513"> 9.1.2 Binary local includes </a> </h6> <h5 class="toc"> <a href="customizing-contents.en.html#517"> 9.2 Hooks </a> </h5> <h6 class="toc"> <a href="customizing-contents.en.html#520"> 9.2.1 Chroot local hooks </a> </h6> <h6 class="toc"> <a href="customizing-contents.en.html#522"> 9.2.2 Binary local hooks </a> </h6> <h6 class="toc"> <a href="customizing-contents.en.html#524"> 9.2.3 Boot-time hooks </a> </h6> <h5 class="toc"> <a href="customizing-contents.en.html#526"> 9.3 Preseeding Debconf questions </a> </h5> <h1 class="toc"> Customizing run time behaviours </h1> <h4 class="toc"> <a href="customizing-run-time-behaviours.en.html" target="_top"> 10. Customizing run time behaviours </a> </h4> <h5 class="toc"> <a href="customizing-run-time-behaviours.en.html#532"> 10.1 Customizing the live user </a> </h5> <h5 class="toc"> <a href="customizing-run-time-behaviours.en.html#541"> 10.2 Customizing locale and language </a> </h5> <h5 class="toc"> <a href="customizing-run-time-behaviours.en.html#558"> 10.3 Persistence </a> </h5> <h6 class="toc"> <a href="customizing-run-time-behaviours.en.html#580"> 10.3.1 The persistence.conf file </a> </h6> <h6 class="toc"> <a href="customizing-run-time-behaviours.en.html#585"> 10.3.2 Using more than one persistence store </a> </h6> <h6 class="toc"> <a href="customizing-run-time-behaviours.en.html#591"> 10.3.3 Using persistence with encryption </a> </h6> <h1 class="toc"> Customizing the binary image </h1> <h4 class="toc"> <a href="customizing-binary.en.html" target="_top"> 11. Customizing the binary image </a> </h4> <h5 class="toc"> <a href="customizing-binary.en.html#619"> 11.1 Bootloaders </a> </h5> <h5 class="toc"> <a href="customizing-binary.en.html#626"> 11.2 ISO metadata </a> </h5> <h1 class="toc"> Customizing Debian Installer </h1> <h4 class="toc"> <a href="customizing-installer.en.html" target="_top"> 12. Customizing Debian Installer </a> </h4> <h5 class="toc"> <a href="customizing-installer.en.html#636"> 12.1 Types of Debian Installer </a> </h5> <h5 class="toc"> <a href="customizing-installer.en.html#648"> 12.2 Customizing Debian Installer by preseeding </a> </h5> <h5 class="toc"> <a href="customizing-installer.en.html#651"> 12.3 Customizing Debian Installer content </a> </h5> <h1 class="toc"> Project </h1> <h1 class="toc"> Contributing to the project </h1> <h4 class="toc"> <a href="contributing-to-project.en.html" target="_top"> 13. Contributing to the project </a> </h4> <h5 class="toc"> <a href="contributing-to-project.en.html#667"> 13.1 Making changes </a> </h5> <h5 class="toc"> <a href="contributing-to-project.en.html#682"> 13.2 Translation of man pages </a> </h5> <h1 class="toc"> Reporting bugs </h1> <h4 class="toc"> <a href="bugs.en.html" target="_top"> 14. Reporting bugs </a> </h4> <h5 class="toc"> <a href="bugs.en.html#698"> 14.1 Known issues </a> </h5> <h5 class="toc"> <a href="bugs.en.html#703"> 14.2 Rebuild from scratch </a> </h5> <h5 class="toc"> <a href="bugs.en.html#705"> 14.3 Use up-to-date packages </a> </h5> <h5 class="toc"> <a href="bugs.en.html#707"> 14.4 Collect information </a> </h5> <h5 class="toc"> <a href="bugs.en.html#724"> 14.5 Isolate the failing case if possible </a> </h5> <h5 class="toc"> <a href="bugs.en.html#726"> 14.6 Use the correct package to report the bug against </a> </h5> <h6 class="toc"> <a href="bugs.en.html#729"> 14.6.1 At build time while bootstrapping </a> </h6> <h6 class="toc"> <a href="bugs.en.html#732"> 14.6.2 At build time while installing packages </a> </h6> <h6 class="toc"> <a href="bugs.en.html#736"> 14.6.3 At boot time </a> </h6> <h6 class="toc"> <a href="bugs.en.html#738"> 14.6.4 At run time </a> </h6> <h5 class="toc"> <a href="bugs.en.html#740"> 14.7 Do the research </a> </h5> <h5 class="toc"> <a href="bugs.en.html#744"> 14.8 Where to report bugs </a> </h5> <h1 class="toc"> Coding Style </h1> <h4 class="toc"> <a href="coding-style.en.html" target="_top"> 15. Coding Style </a> </h4> <h5 class="toc"> <a href="coding-style.en.html#751"> 15.1 Compatibility </a> </h5> <h5 class="toc"> <a href="coding-style.en.html#756"> 15.2 Indenting </a> </h5> <h5 class="toc"> <a href="coding-style.en.html#758"> 15.3 Wrapping </a> </h5> <h5 class="toc"> <a href="coding-style.en.html#770"> 15.4 Variables </a> </h5> <h5 class="toc"> <a href="coding-style.en.html#789"> 15.5 Miscellaneous </a> </h5> <h1 class="toc"> Procedures </h1> <h4 class="toc"> <a href="procedures.en.html" target="_top"> 16. Procedures </a> </h4> <h5 class="toc"> <a href="procedures.en.html#797"> 16.1 Major Releases </a> </h5> <h5 class="toc"> <a href="procedures.en.html#803"> 16.2 Point Releases </a> </h5> <h6 class="toc"> <a href="procedures.en.html#807"> 16.2.1 Last Point Release of a Debian Release </a> </h6> <h6 class="toc"> <a href="procedures.en.html#809"> 16.2.2 Point release announcement template </a> </h6> <h1 class="toc"> Git repositories </h1> <h4 class="toc"> <a href="git-repositories.en.html" target="_top"> 17. Git repositories </a> </h4> <h5 class="toc"> <a href="git-repositories.en.html#829"> 17.1 Handling multiple repositories </a> </h5> <h1 class="toc"> Examples </h1> <h1 class="toc"> Examples </h1> <h4 class="toc"> <a href="examples.en.html" target="_top"> 18. Examples </a> </h4> <h5 class="toc"> <a href="examples.en.html#837"> 18.1 Using the examples </a> </h5> <h5 class="toc"> <a href="examples.en.html#841"> 18.2 Tutorial 1: A default image </a> </h5> <h5 class="toc"> <a href="examples.en.html#850"> 18.3 Tutorial 2: A web browser utility </a> </h5> <h5 class="toc"> <a href="examples.en.html#858"> 18.4 Tutorial 3: A personalized image </a> </h5> <h6 class="toc"> <a href="examples.en.html#861"> 18.4.1 First revision </a> </h6> <h6 class="toc"> <a href="examples.en.html#875"> 18.4.2 Second revision </a> </h6> <h5 class="toc"> <a href="examples.en.html#887"> 18.5 A VNC Kiosk Client </a> </h5> <h5 class="toc"> <a href="examples.en.html#901"> 18.6 A base image for a 128MB USB key </a> </h5> <h5 class="toc"> <a href="examples.en.html#912"> 18.7 A localized GNOME desktop and installer </a> </h5> <h1 class="toc"> Appendix </h1> <h1 class="toc"> Style guide </h1> <h4 class="toc"> <a href="style-guide.en.html" target="_top"> 19. Style guide </a> </h4> <h5 class="toc"> <a href="style-guide.en.html#927"> 19.1 Guidelines for authors </a> </h5> <h6 class="toc"> <a href="style-guide.en.html#930"> 19.1.1 Linguistic features </a> </h6> <h6 class="toc"> <a href="style-guide.en.html#963"> 19.1.2 Procedures </a> </h6> <h5 class="toc"> <a href="style-guide.en.html#1002"> 19.2 Guidelines for translators </a> </h5> <h6 class="toc"> <a href="style-guide.en.html#1006"> 19.2.1 Translation hints </a> </h6> <h1 class="toc"> <b><a href="metadata.en.html">Metadata</a></b> </h1> <h4 class="toc"> <a href="metadata.en.html" target="_top"> SiSU Metadata, document information </a> </h4> <p class="small_left">Rights: Copyright: Copyright (C) 2006-2015 Live Systems Project <br> 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. <br> <br> 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. <br> <br> You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. <br> <br> The complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL-3 file.</p> <p> </p> <div class="main_column"> <p> </p> <a name="bottom" id="bottom"></a> <a name="end" id="end"></a> </div> </div> </div> </body> </html>