X-Git-Url: https://git.grml.org/?a=blobdiff_plain;ds=sidebyside;f=grml-live%2Findex.html;h=249be41b4e7c612f54147399463cb2b623cc3c9c;hb=02fbfdec2a70d95baa9f169844b4b9602a21c3e3;hp=6e6d4efeec6f5772e08cb8caaf43b1e3132d62f5;hpb=d45fb6db2ac70b229c2a890c58bc1871a3f0745f;p=grml.org.git

diff --git a/grml-live/index.html b/grml-live/index.html
index 6e6d4ef..249be41 100644
--- a/grml-live/index.html
+++ b/grml-live/index.html
@@ -1,9 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.9" />
+<meta name="generator" content="AsciiDoc 8.6.10" />
 <title>grml-live(8)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -754,7 +755,7 @@ Linux Live system (CD/ISO)</p></div>
 -e &lt;extract_iso_name&gt;] [-g &lt;grml_name&gt;] [-i &lt;iso_name&gt;] [
 -o &lt;output_directory&gt;] [-r &lt;release_name&gt;] [-s &lt;suite&gt;] [
 -t &lt;template_directory&gt;] [-v &lt;version_number&gt;] [-U &lt;username&gt;] [
--AbBFnNqQuVz]</p></div>
+-w &lt;date&gt;] [-AbBFnNqQuVz]</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -790,8 +791,7 @@ completely independent at the same time!</td>
 <td class="content">Please notice that you should have a fast network connection as all the Debian
 packages will be downloaded and installed via network. If you want to use a
 local mirror (strongly recommended if you plan to use grml-live more than once)
-checkout mkdebmirror (see /usr/share/doc/grml-live/examples/mkdebmirror),
-debmirror(1), reprepro(1) (see /usr/share/doc/grml-live/examples/reprepro/ for a
+checkout debmirror(1), reprepro(1) (see /usr/share/doc/grml-live/examples/reprepro/ for a
 sample configuration), apt-cacher(1) and approx(8). To avoid downloading the
 base system again and again check out <a href="#create-a-base-tgz">the base tar.gz feature</a>.</td>
 </tr></table>
@@ -853,12 +853,10 @@ really know that you do not want to update the chroot.
 <p>
 Specify the CLASSES to be used for building the ISO via FAI.  By default only
 the classes GRMLBASE, GRML_FULL and I386/AMD64 (depending on system
-architecture) are assumed, resulting in a base system of about 350MB
-total ISO size. If using a non-I386 system (like AMD64) you should specify the
-appropriate architecture as well. Additionally you can specify a class providing
-a grml-kernel (see <a href="#classes">the <em>CLASSES</em> section in this document</a> for
-details about available classes).  So instead of GRML_FULL you can also use
-GRML_SMALL and GRML_FULL.
+architecture) are assumed.  Additionally you can specify a class providing a
+(grml-)kernel (see <a href="#classes">the <em>CLASSES</em> section in this document</a> for
+details about available classes). So instead of GRML_FULL you can also use e.g.
+GRML_SMALL.
 </p>
 </dd>
 </dl></div>
@@ -1041,7 +1039,7 @@ Specify name of the release.
 <p>
 Specify the Debian suite you want to use for your live-system. If unset defaults
 to "testing". Supported values are: stable, testing, unstable (or their
-corresponding release names like "wheezy"). Please be aware that recent Debian
+corresponding release names like "stretch"). Please be aware that recent Debian
 suites might require a recent base.tgz
 debootstrap.
 </p>
@@ -1089,6 +1087,26 @@ Increase verbosity in the build process.
 </p>
 </dd>
 <dt class="hdlist1">
+-w <strong>DATE</strong>
+</dt>
+<dd>
+<p>
+The wayback machine. Build the system using Debian archives from the specified
+date.  Valid date formats are yyyymmddThhmmssZ or simply yyyymmdd.  To learn
+which snapshots exist, i.e. which date strings are valid, simply browse the
+lists on <a href="http://snapshot.debian.org/">http://snapshot.debian.org/</a>.  If there is no import at the exact time
+you specified you will get the latest available timestamp which is before the
+time you specified.
+This option is useful especially for release and debugging builds - for example
+if you know that the Debian archive was in a good state on a specific date but
+you want to build it on another day in the future, where the archive might not
+be as needed anymore. Please be aware that this is restricted to the plain
+Debian repositories only, as referred to in /etc/apt/sources.list.d/debian.list
+(so neither the Grml repositories nor any further custom ones are affected by
+the wayback machine).
+</p>
+</dd>
+<dt class="hdlist1">
 -z
 </dt>
 <dd>
@@ -1102,7 +1120,7 @@ Use ZLIB instead of LZMA/XZ compression in mksquashfs part of the build process.
 <div class="sect1">
 <h2 id="usage-examples">5. Usage examples</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>To get a Debian-stable and Grml-based Live-CD using /grml/grml-live
+<div class="paragraph"><p>To get a Debian-stable and Grml-based Live-CD using ./grml
 as build and output directory just run:</p></div>
 <div class="literalblock">
 <div class="content">
@@ -1171,7 +1189,7 @@ losing the simplicity in the build process.</p></div>
 recommended to <strong>always</strong> use the class GRMLBASE when building an ISO using
 grml-live, as well as the architecture dependent class which provides the kernel
 (being <em>I386</em> for x86_32 and <em>AMD64</em> for x86_64) and a GRML_* class (like
-GRML_SMALL, GRML_MEDIUM or GRML_FULL). The following files and directories are
+GRML_SMALL or GRML_FULL). The following files and directories are
 relevant for class GRMLBASE by default:</p></div>
 <div class="literalblock">
 <div class="content">
@@ -1206,6 +1224,17 @@ DEBORPHAN: get rid of all packages listed in output of deborphan
 </li>
 <li>
 <p>
+FILE_RC: instead of using systemd as init system use file-rc instead. file-rc
+was the init system used by Grml until and including stable release 2014.11,
+starting with beginning of 2016 Grml switched to systemd instead. If you want to
+build a live system in the old style using file-rc instead of systemd then enable
+this class. Please notice that support for file-rc is no longer being actively
+maintained (the Grml team happily accepts patches though) and file-rc (upstream
+wise) might disappear too.
+</p>
+</li>
+<li>
+<p>
 FRESHCLAM: execute freshclam (if it&#8217;s present) to update clamav definitions
 (increases resulting ISO size ~70MB). By default it&#8217;s skipped to avoid bigger
 ISO size.
@@ -1216,35 +1245,29 @@ ISO size.
 GRMLBASE: the main class responsible for getting a minimal subset of what&#8217;s
 defining a Grml system. Important parts of the buildprocess are specified in
 this class as well, so unless you have a really good reason you should always
-use this class.
+use this class. Please be aware that using <strong>just</strong> the GRMLBASE class won&#8217;t be
+enough, because the kernel packages (e.g. linux-image-i386-grml<br />
+linux-image-amd64-grml) are chosen in further GRML_* classes (to provide maximum
+flexibility with kernel selection). If you don&#8217;t want to use the existing
+GRML_FULL or GRML_SMALL classes, define your own CLASS file choosing the kernel
+package you want to use (and don&#8217;t forget to include your CLASS in the arguments
+of grml-live&#8217;s -c&#8230; command line option).
 </p>
 </li>
 <li>
 <p>
 GRML_FULL: full featured Grml, also known as the "normal", full grml as
-introduced in December 2011 (~350MB ISO size).
-</p>
-</li>
-<li>
-<p>
-GRML_MEDIUM: medium sized Grml version, used to be known as grml-medium
-until December 2011 (~220MB ISO size).
+introduced in December 2011 (~600MB ISO size).
 </p>
 </li>
 <li>
 <p>
-GRML_SMALL: minimum sized Grml version, known as grml-small (~110MB ISO
+GRML_SMALL: minimum sized Grml version, known as grml-small (~300MB ISO
 size).
 </p>
 </li>
 <li>
 <p>
-GRML_XL: large size Grml version, used to be known as "full grml" until
-December 2011 (~700MB ISO size).
-</p>
-</li>
-<li>
-<p>
 LATEX: LaTeX(-related) packages like auctex, texlive,&#8230;
 (which used to be shipped by grml before the LaTeX removal)
 </p>
@@ -1367,7 +1390,7 @@ installation process.</p></div>
 <div class="paragraph"><p>Directory with lists of software packages to be installed or removed.  The
 different classes describe what should find its way to your ISO.  When running
 "grml-live -c GRMLBASE,GRML_SMALL,AMD64 &#8230;" only the configuration of GRMLBASE,
-GRML_SMALL and and AMD64 will be taken. If you use <em>grml-live -c
+GRML_SMALL and AMD64 will be taken. If you use <em>grml-live -c
 GRMLBASE,GRML_SMALL,AMD64,FOOBAR &#8230;</em> then the files of GRMLBASE, GRML_SMALL,
 AMD64 <strong>plus</strong> the files from FOOBAR will be taken. So just create a new class to
 adjust the package selection according to your needs.  Please notice that the
@@ -1408,11 +1431,11 @@ on a plain, original Debian system.
 </li>
 <li>
 <p>
-enough free disk space; at least 800MB are required for a minimal grml-live
-run (~400MB for the chroot [$CHROOT_OUTPUT], ~150MB for the build target
-[$BUILD_OUTPUT] and \~150MB for the resulting ISO [$ISO_OUTPUT] plus some
-temporary files), if you plan to use GRML_FULL you should have at least 4GB of
-total free disk space
+enough free disk space; at least 1.5GB are required for a minimal grml-live
+run (~850MB for the chroot [$CHROOT_OUTPUT], ~300MB for the build target
+[$BUILD_OUTPUT], ~30MB for the netboot files and \~300MB for the resulting ISO
+[$ISO_OUTPUT] plus some temporary files), if you plan to use GRML_FULL you
+should have at least 4GB of total free disk space
 </p>
 </li>
 <li>
@@ -1428,9 +1451,8 @@ chroot (check out "local mirror" to workaround this problem as far as possible)
 <div class="sect1">
 <h2 id="current_state">12. Current state of grml-live with squashfs-tools and kernel</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>Use squashfs-tools &gt;=4.2-1 (available from Grml repositories as well as from
-Debian) to build Grml (based) ISOs featuring kernel version 2.6.38-grml[64] or
-newer.</p></div>
+<div class="paragraph"><p>Use squashfs-tools &gt;=4.2-1 to build Grml (based) ISOs featuring kernel version
+2.6.38-grml[64] or newer.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1441,8 +1463,8 @@ newer.</p></div>
 <div class="paragraph"><p>The easiest way to get a running grml-live setup is to just use Grml.
 Of course using grml-live on a plain, original Debian installation is supported
 as well. So there we go.</p></div>
-<div class="paragraph"><p>What we have: plain, original Debian wheezy (7.x).</p></div>
-<div class="paragraph"><p>What we want: build a Grml ISO based on Debian/wheezy for the amd64 architecture
+<div class="paragraph"><p>What we have: plain, original Debian stretch (9.x).</p></div>
+<div class="paragraph"><p>What we want: build a Grml ISO based on Debian/stretch for the amd64 architecture
 using grml-live.</p></div>
 <div class="sect3">
 <h4 id="_instructions">13.1.1. Instructions</h4>
@@ -1494,9 +1516,9 @@ cat &gt; /etc/grml/grml-live.local &lt;&lt; EOF
 # SQUASHFS_BINARY='/usr/bin/mksquashfs'
 ## install local files into the chroot
 # CHROOT_INSTALL="/etc/grml/fai/chroot_install"
-## adjust if necessary (defaults to /grml/grml-live):
+## adjust if necessary (defaults to ./grml/):
 ## OUTPUT="/srv/grml-live"
-FAI_DEBOOTSTRAP="wheezy http://http.debian.net/debian/"
+FAI_DEBOOTSTRAP="stretch http://ftp.debian.org/debian/"
 # ARCH="amd64"
 CLASSES="GRMLBASE,GRML_FULL,AMD64"
 EOF</code></pre>
@@ -1578,7 +1600,7 @@ adjust MIRROR_DIRECTORY in /etc/grml/grml-live.conf[.local] as well.</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code># cat &gt; /etc/grml/fai/config/package_config/MIKA &lt;&lt; EOF
-PACKAGES aptitude</code></pre>
+PACKAGES install</code></pre>
 </div></div>
 <div class="literalblock">
 <div class="content">
@@ -1604,13 +1626,45 @@ dpkg -i --force-confnew --force-confmiss /path/to/grml-live_..._all.deb</code></
 </div></div>
 </div>
 <div class="sect2">
-<h3 id="create-a-base-tgz">13.8. How do I create a base.tgz?</h3>
-<div class="paragraph"><p>First of all create the chroot using debootstrap:</p></div>
+<h3 id="apt-cacher">13.8. Set up apt-cacher-ng for use with grml-live</h3>
+<div class="paragraph"><p>Make sure /etc/grml/grml-live.local provides according APT_PROXY and
+FAI_DEBOOTSTRAP:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code>BASECHROOT='/tmp/basefile'
-debootstrap wheezy "$BASECHROOT" http://http.debian.net/debian
-tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./</code></pre>
+<pre><code># cat /etc/grml/grml-live.local
+[...]
+APT_PROXY="http://localhost:3142/"
+[...]
+FAI_DEBOOTSTRAP="stretch http://localhost:3142/ftp.debian.org/debian stretch main contrib non-free"</code></pre>
+</div></div>
+<div class="paragraph"><p>Make sure apt-cacher-ng is running (<em>/etc/init.d/apt-cacher-ng restart</em>).
+That&#8217;s it.  All downloaded files will be cached in /var/cache/apt-cacher-ng then.</p></div>
+</div>
+<div class="sect2">
+<h3 id="revert_manifold">13.9. How do I revert the manifold feature from an ISO?</h3>
+<div class="paragraph"><p>The so called manifold feature Grml ISOs use by default allows one to use the same
+ISO for CD boot and USB boot. If you notice any problems when booting just
+revert the manifold feature running:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</code></pre>
+</div></div>
+<div class="paragraph"><p>To switch from manifold to isohybrid mode (an alternative approach provided by
+syslinux) then just execute:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>% isohybrid grml.iso</code></pre>
+</div></div>
+</div>
+<div class="sect2">
+<h3 id="create-a-base-tgz">13.10. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>
+<div class="paragraph" id="basetgz"><p>First of all create the chroot using debootstrap (requires root):</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>BASECHROOT='/tmp/basefile'  # path where the chroot gets generated
+SUITE='stretch'              # using the current stable release should always work
+debootstrap --exclude=info,tasksel,tasksel-data "$SUITE" "$BASECHROOT" http://ftp.debian.org/debian
+tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf "${SUITE}".tar.gz ./</code></pre>
 </div></div>
 <div class="admonitionblock">
 <table><tr>
@@ -1623,9 +1677,10 @@ then invoke debootstrap using the <em>--arch i386</em> option. Disclaimer: build
 AMD64 base.tgz won&#8217;t work if you are using a 32bit kernel system of course.</td>
 </tr></table>
 </div>
-<div class="paragraph"><p>Then move the base.tar.gz to /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz.
-Use e.g. I386 as $CLASSNAME for i386 chroots and AMD64 for amd64 chroots.</p></div>
-<div class="paragraph"><p>Now executing grml-live should use this file as base system instead of executing
+<div class="paragraph"><p>Finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note
+that it needs to be uppercase letters matching the class names, so: e.g.
+AMD64.tar.gz for amd64 and I386.tar.gz for i386).</p></div>
+<div class="paragraph"><p>Then executing grml-live should use this file as base system instead of executing
 debootstrap. Check out the output for something like:</p></div>
 <div class="literalblock">
 <div class="content">
@@ -1633,71 +1688,82 @@ debootstrap. Check out the output for something like:</p></div>
 ftar: extracting //etc/grml/fai/config/basefiles///AMD64.tar.gz to /srv/grml64_testing/grml_chroot//
 [...]</code></pre>
 </div></div>
-<div class="admonitionblock">
-<table><tr>
-<td class="icon">
-<img src="./images/icons/tip.png" alt="Tip" />
-</td>
-<td class="content">Existing base.tgz can be found at <a href="http://daily.grml.org/">http://daily.grml.org/</a></td>
-</tr></table>
-</div>
 </div>
 <div class="sect2">
-<h3 id="apt-cacher">13.9. Set up apt-cacher-ng for use with grml-live</h3>
-<div class="paragraph"><p>Make sure /etc/grml/grml-live.local provides according APT_PROXY and
-FAI_DEBOOTSTRAP:</p></div>
+<h3 id="localrepos">13.11. How to use your own local repository</h3>
+<div class="paragraph"><p>Let&#8217;s assume you have Debian package(s) in your filesystem inside
+<code>/home/foobar/local-packages</code> and want to provide them to your grml-live build.
+This can be achieved either 1) through a bind mount (using the MIRROR_DIRECTORY
+configuration) or 2) by serving a repository via HTTP.</p></div>
+<div class="sect3">
+<h4 id="_serving_via_bind_mount_mirror_directory">13.11.1. Serving via bind mount / MIRROR_DIRECTORY</h4>
+<div class="paragraph"><p>Make sure to create an according sources.list configuration file, e.g. using
+your own class name <code>CUSTOM</code>:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code># cat /etc/grml/grml-live.local
-[...]
-APT_PROXY="http://localhost:3142/"
-[...]
-FAI_DEBOOTSTRAP="wheezy http://localhost:3142/http.debian.net/debian wheezy main contrib non-free"</code></pre>
+<pre><code># cat &gt; /etc/grml/fai/config/files/etc/apt/sources.list.d/local-packages.list/CUSTOM &lt;&lt; EOF
+deb file:///home/foobar/local-packages ./
+EOF</code></pre>
 </div></div>
-<div class="paragraph"><p>Make sure apt-cacher-ng is running (<em>/etc/init.d/apt-cacher-ng restart</em>).
-That&#8217;s it.  All downloaded files will be cached in /var/cache/apt-cacher-ng then.</p></div>
-</div>
-<div class="sect2">
-<h3 id="revert_manifold">13.10. How do I revert the manifold feature from an ISO?</h3>
-<div class="paragraph"><p>The so called manifold feature Grml ISOs use by default allows one to use the same
-ISO for CD boot and USB boot. If you notice any problems when booting just
-revert the manifold feature running:</p></div>
+<div class="paragraph"><p>Add the according MIRROR_DIRECTORY configuration to your grml-live configuration:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code>% dd if=/dev/zero of=grml.iso bs=512 count=1 conv=notrunc</code></pre>
+<pre><code># echo "MIRROR_DIRECTORY='/home/foobar/packages'" &gt;&gt; /etc/grml/grml-live.local</code></pre>
 </div></div>
-<div class="paragraph"><p>To switch from manifold to isohybrid mode (an alternative approach provided by
-syslinux) then just execute:</p></div>
+<div class="paragraph"><p>Make sure the local directory looks like a mirror:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code>% isohybrid grml.iso</code></pre>
+<pre><code>% cd /home/foobar/packages
+% dpkg-scanpackages . /dev/null | gzip &gt; Packages.gz</code></pre>
 </div></div>
+<div class="paragraph"><p>Finally invoke grml-live with your class name (<code>CUSTOM</code> in this example) added
+to the list of classes on the command line (see grml-live option <code>-c</code>).</p></div>
 </div>
-<div class="sect2">
-<h3 id="basetgz">13.11. How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz)</h3>
-<div class="paragraph"><p>Execute the following commands (requires root):</p></div>
+<div class="sect3">
+<h4 id="_serving_a_repository_via_http">13.11.2. Serving a repository via HTTP</h4>
+<div class="paragraph"><p>Make sure to create an according sources.list configuration file, e.g. using
+your own class name <code>CUSTOM</code>:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># cat &gt; /etc/grml/fai/config/files/etc/apt/sources.list.d/local-packages.list/CUSTOM &lt;&lt; EOF
+deb http://127.0.0.1:8000/ ./
+EOF</code></pre>
+</div></div>
+<div class="paragraph"><p>Make sure the local directory is served via HTTP on the according IP address and
+port. For the <code>http://127.0.0.1:8000/</code> example from above it should be enough to
+just invoke:</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><code>ARCH='amd64' # replace with i386 if necessary
-SUITE='wheezy' # using the current stable release should always work
-debootstrap --arch "$ARCH" --exclude=info,tasksel,tasksel-data "$SUITE" "$ARCH" http://debian.netcologne.de/debian
-cd "$ARCH"
-rm var/cache/apt/archives/*.deb
-tar zcf ../"${ARCH}".tar.gz *</code></pre>
+<pre><code>% cd /home/foobar/packages
+% dpkg-scanpackages . /dev/null | gzip &gt; Packages.gz
+% python -m SimpleHTTPServer 8000</code></pre>
 </div></div>
-<div class="paragraph"><p>And finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note
-that it needs to be uppercase letters matching the class names, so: AMD64.tar.gz
-for amd64 and I386.tar.gz for i386).</p></div>
+<div class="admonitionblock">
+<table><tr>
+<td class="icon">
+<img src="./images/icons/tip.png" alt="Tip" />
+</td>
+<td class="content">Of course you can also use a real Debian repository setup using tools like
+reprepro(1) and/or using a real web server, though for quick debugging sessions
+python&#8217;s SimpleHTTPServer in combination with dpkg-scanpackages from package
+dpkg-dev is a simple and easy approach.</td>
+</tr></table>
+</div>
+<div class="paragraph"><p>Finally invoke grml-live with your class name (<code>CUSTOM</code> in this example) added
+to the list of classes on the command line (see grml-live option <code>-c</code>).</p></div>
+</div>
 </div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="download">14. Download / install grml-live as a Debian package</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>Debian packages are available through the grml-repository at
-<a href="http://deb.grml.org/pool/main/g/grml-live/">deb.grml.org</a>.  If you want to
-build a Debian package on your own (using for example a specific version or the
-current development tree), just execute:</p></div>
+<div class="paragraph"><p>Stable Debian packages are available through the grml-repository at
+<a href="http://deb.grml.org/pool/main/g/grml-live/">deb.grml.org</a> and the latest
+Git commits are available as Debian packages from
+<a href="http://jenkins.grml.org/job/grml-live-binaries/">jenkins.grml.org</a>.
+If you want to build a Debian package on your own (using for example a specific
+version or the current development tree), just execute:</p></div>
 <div class="literalblock">
 <div class="content">
 <pre><code>git clone git://git.grml.org/grml-live
@@ -1707,21 +1773,37 @@ debuild -us -uc</code></pre>
 </div>
 </div>
 <div class="sect1">
-<h2 id="source">15. Source</h2>
+<h2 id="run-from-git">15. Run grml-live directly from git</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>In case you want to run grml-live directly from the git repository checkout
+(after making sure all dependencies are installed), you should set
+<code>GRML_FAI_CONFIG</code> so that a) it finds the according FAI configuration files and
+b) does not use the config files of an possibly installed <code>grml-live</code> package.
+Usage example:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code># export GRML_FAI_CONFIG=$(pwd)/etc/grml/fai
+# export SCRIPTS_DIRECTORY=$(pwd)/scripts
+# ./grml-live -s sid -a amd64 -c GRMLBASE,GRML_FULL,AMD64</code></pre>
+</div></div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="source">16. Source</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>The source of grml-live is available at
 <a href="https://github.com/grml/grml-live/">https://github.com/grml/grml-live/</a></p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="bugs">16. Bugs</h2>
+<h2 id="bugs">17. Bugs</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Please report feedback, <a href="http://grml.org/bugs/">bugreports</a> and wishes
 <a href="http://grml.org/contact/">to the Grml team</a>!</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="documentation">17. Documentation</h2>
+<h2 id="documentation">18. Documentation</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>The most recent grml-live documentation is available online at
 <a href="http://grml.org/grml-live/">http://grml.org/grml-live/</a> and for offline reading also available
@@ -1741,7 +1823,7 @@ in different formats:</p></div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="authors">18. Authors</h2>
+<h2 id="authors">19. Authors</h2>
 <div class="sectionbody">
 <div class="paragraph"><p>Michael Prokop &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;</p></div>
 </div>
@@ -1750,7 +1832,8 @@ in different formats:</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2013-12-11 11:53:34 CET
+Last updated
+ 2018-10-25 14:47:41 UTC
 </div>
 </div>
 </body>
