1 <?xml version="1.0" encoding="UTF-8"?>
\r
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
6 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
\r
7 <meta name="generator" content="AsciiDoc 8.6.10" />
\r
8 <title>grml-debootstrap(8)</title>
\r
9 <style type="text/css">
\r
10 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
\r
14 font-family: Georgia,serif;
\r
18 h1, h2, h3, h4, h5, h6,
\r
19 div.title, caption.title,
\r
20 thead, p.table.header,
\r
22 #author, #revnumber, #revdate, #revremark,
\r
24 font-family: Arial,Helvetica,sans-serif;
\r
28 margin: 1em 5% 1em 5%;
\r
33 text-decoration: underline;
\r
49 h1, h2, h3, h4, h5, h6 {
\r
52 margin-bottom: 0.5em;
\r
57 border-bottom: 2px solid silver;
\r
77 border: 1px solid silver;
\r
82 margin-bottom: 0.5em;
\r
88 ul > li { color: #aaa; }
\r
89 ul > li > * { color: black; }
\r
91 .monospaced, code, pre {
\r
92 font-family: "Courier New", Courier, monospace;
\r
99 white-space: pre-wrap;
\r
109 #revnumber, #revdate, #revremark {
\r
114 border-top: 2px solid silver;
\r
115 padding-top: 0.5em;
\r
120 padding-bottom: 0.5em;
\r
124 padding-bottom: 0.5em;
\r
129 margin-bottom: 1.5em;
\r
131 div.imageblock, div.exampleblock, div.verseblock,
\r
132 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
133 div.admonitionblock {
\r
135 margin-bottom: 1.5em;
\r
137 div.admonitionblock {
\r
139 margin-bottom: 2.0em;
\r
144 div.content { /* Block element content. */
\r
148 /* Block element titles. */
\r
149 div.title, caption.title {
\r
154 margin-bottom: 0.5em;
\r
160 td div.title:first-child {
\r
163 div.content div.title:first-child {
\r
166 div.content + div.title {
\r
170 div.sidebarblock > div.content {
\r
171 background: #ffffee;
\r
172 border: 1px solid #dddddd;
\r
173 border-left: 4px solid #f0f0f0;
\r
177 div.listingblock > div.content {
\r
178 border: 1px solid #dddddd;
\r
179 border-left: 5px solid #f0f0f0;
\r
180 background: #f8f8f8;
\r
184 div.quoteblock, div.verseblock {
\r
185 padding-left: 1.0em;
\r
186 margin-left: 1.0em;
\r
188 border-left: 5px solid #f0f0f0;
\r
192 div.quoteblock > div.attribution {
\r
193 padding-top: 0.5em;
\r
197 div.verseblock > pre.content {
\r
198 font-family: inherit;
\r
199 font-size: inherit;
\r
201 div.verseblock > div.attribution {
\r
202 padding-top: 0.75em;
\r
205 /* DEPRECATED: Pre version 8.2.7 verse style literal block. */
\r
206 div.verseblock + div.attribution {
\r
210 div.admonitionblock .icon {
\r
211 vertical-align: top;
\r
214 text-decoration: underline;
\r
216 padding-right: 0.5em;
\r
218 div.admonitionblock td.content {
\r
219 padding-left: 0.5em;
\r
220 border-left: 3px solid #dddddd;
\r
223 div.exampleblock > div.content {
\r
224 border-left: 3px solid #dddddd;
\r
225 padding-left: 0.5em;
\r
228 div.imageblock div.content { padding-left: 0; }
\r
229 span.image img { border-style: none; vertical-align: text-bottom; }
\r
230 a.image:visited { color: white; }
\r
234 margin-bottom: 0.8em;
\r
239 font-style: normal;
\r
242 dd > *:first-child {
\r
247 list-style-position: outside;
\r
250 list-style-type: decimal;
\r
253 list-style-type: lower-alpha;
\r
256 list-style-type: upper-alpha;
\r
259 list-style-type: lower-roman;
\r
262 list-style-type: upper-roman;
\r
265 div.compact ul, div.compact ol,
\r
266 div.compact p, div.compact p,
\r
267 div.compact div, div.compact div {
\r
269 margin-bottom: 0.1em;
\r
281 margin-bottom: 0.8em;
\r
284 padding-bottom: 15px;
\r
286 dt.hdlist1.strong, td.hdlist1.strong {
\r
290 vertical-align: top;
\r
291 font-style: normal;
\r
292 padding-right: 0.8em;
\r
296 vertical-align: top;
\r
298 div.hdlist.compact tr {
\r
304 background: yellow;
\r
307 .footnote, .footnoteref {
\r
311 span.footnote, span.footnoteref {
\r
312 vertical-align: super;
\r
316 margin: 20px 0 20px 0;
\r
317 padding: 7px 0 0 0;
\r
320 #footnotes div.footnote {
\r
326 border-top: 1px solid silver;
\r
335 padding-right: 0.5em;
\r
336 padding-bottom: 0.3em;
\r
337 vertical-align: top;
\r
339 div.colist td img {
\r
344 #footer-badges { display: none; }
\r
348 margin-bottom: 2.5em;
\r
356 margin-bottom: 0.1em;
\r
359 div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
\r
376 span.aqua { color: aqua; }
\r
377 span.black { color: black; }
\r
378 span.blue { color: blue; }
\r
379 span.fuchsia { color: fuchsia; }
\r
380 span.gray { color: gray; }
\r
381 span.green { color: green; }
\r
382 span.lime { color: lime; }
\r
383 span.maroon { color: maroon; }
\r
384 span.navy { color: navy; }
\r
385 span.olive { color: olive; }
\r
386 span.purple { color: purple; }
\r
387 span.red { color: red; }
\r
388 span.silver { color: silver; }
\r
389 span.teal { color: teal; }
\r
390 span.white { color: white; }
\r
391 span.yellow { color: yellow; }
\r
393 span.aqua-background { background: aqua; }
\r
394 span.black-background { background: black; }
\r
395 span.blue-background { background: blue; }
\r
396 span.fuchsia-background { background: fuchsia; }
\r
397 span.gray-background { background: gray; }
\r
398 span.green-background { background: green; }
\r
399 span.lime-background { background: lime; }
\r
400 span.maroon-background { background: maroon; }
\r
401 span.navy-background { background: navy; }
\r
402 span.olive-background { background: olive; }
\r
403 span.purple-background { background: purple; }
\r
404 span.red-background { background: red; }
\r
405 span.silver-background { background: silver; }
\r
406 span.teal-background { background: teal; }
\r
407 span.white-background { background: white; }
\r
408 span.yellow-background { background: yellow; }
\r
410 span.big { font-size: 2em; }
\r
411 span.small { font-size: 0.6em; }
\r
413 span.underline { text-decoration: underline; }
\r
414 span.overline { text-decoration: overline; }
\r
415 span.line-through { text-decoration: line-through; }
\r
417 div.unbreakable { page-break-inside: avoid; }
\r
427 margin-bottom: 1.5em;
\r
429 div.tableblock > table {
\r
430 border: 3px solid #527bbd;
\r
432 thead, p.table.header {
\r
439 /* Because the table frame attribute is overriden by CSS in most browsers. */
\r
440 div.tableblock > table[frame="void"] {
\r
441 border-style: none;
\r
443 div.tableblock > table[frame="hsides"] {
\r
444 border-left-style: none;
\r
445 border-right-style: none;
\r
447 div.tableblock > table[frame="vsides"] {
\r
448 border-top-style: none;
\r
449 border-bottom-style: none;
\r
460 margin-bottom: 1.5em;
\r
462 thead, p.tableblock.header {
\r
471 border-spacing: 0px;
\r
472 border-style: solid;
\r
473 border-color: #527bbd;
\r
474 border-collapse: collapse;
\r
476 th.tableblock, td.tableblock {
\r
479 border-style: solid;
\r
480 border-color: #527bbd;
\r
483 table.tableblock.frame-topbot {
\r
484 border-left-style: hidden;
\r
485 border-right-style: hidden;
\r
487 table.tableblock.frame-sides {
\r
488 border-top-style: hidden;
\r
489 border-bottom-style: hidden;
\r
491 table.tableblock.frame-none {
\r
492 border-style: hidden;
\r
495 th.tableblock.halign-left, td.tableblock.halign-left {
\r
498 th.tableblock.halign-center, td.tableblock.halign-center {
\r
499 text-align: center;
\r
501 th.tableblock.halign-right, td.tableblock.halign-right {
\r
505 th.tableblock.valign-top, td.tableblock.valign-top {
\r
506 vertical-align: top;
\r
508 th.tableblock.valign-middle, td.tableblock.valign-middle {
\r
509 vertical-align: middle;
\r
511 th.tableblock.valign-bottom, td.tableblock.valign-bottom {
\r
512 vertical-align: bottom;
\r
522 padding-top: 0.5em;
\r
523 padding-bottom: 0.5em;
\r
524 border-top: 2px solid silver;
\r
525 border-bottom: 2px solid silver;
\r
528 border-style: none;
\r
530 body.manpage div.sectionbody {
\r
535 body.manpage div#toc { display: none; }
\r
540 <script type="text/javascript">
\r
542 var asciidoc = { // Namespace.
\r
544 /////////////////////////////////////////////////////////////////////
\r
545 // Table Of Contents generator
\r
546 /////////////////////////////////////////////////////////////////////
\r
548 /* Author: Mihai Bazon, September 2002
\r
549 * http://students.infoiasi.ro/~mishoo
\r
551 * Table Of Content generator
\r
554 * Feel free to use this script under the terms of the GNU General Public
\r
555 * License, as long as you do not remove or alter this notice.
\r
558 /* modified by Troy D. Hanson, September 2006. License: GPL */
\r
559 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
\r
561 // toclevels = 1..4.
\r
562 toc: function (toclevels) {
\r
564 function getText(el) {
\r
566 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
567 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
\r
569 else if (i.firstChild != null)
\r
570 text += getText(i);
\r
575 function TocEntry(el, text, toclevel) {
\r
578 this.toclevel = toclevel;
\r
581 function tocEntries(el, toclevels) {
\r
582 var result = new Array;
\r
583 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
\r
584 // Function that scans the DOM tree for header elements (the DOM2
\r
585 // nodeIterator API would be a better technique but not supported by all
\r
587 var iterate = function (el) {
\r
588 for (var i = el.firstChild; i != null; i = i.nextSibling) {
\r
589 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
\r
590 var mo = re.exec(i.tagName);
\r
591 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
\r
592 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
\r
602 var toc = document.getElementById("toc");
\r
607 // Delete existing TOC entries in case we're reloading the TOC.
\r
608 var tocEntriesToRemove = [];
\r
610 for (i = 0; i < toc.childNodes.length; i++) {
\r
611 var entry = toc.childNodes[i];
\r
612 if (entry.nodeName.toLowerCase() == 'div'
\r
613 && entry.getAttribute("class")
\r
614 && entry.getAttribute("class").match(/^toclevel/))
\r
615 tocEntriesToRemove.push(entry);
\r
617 for (i = 0; i < tocEntriesToRemove.length; i++) {
\r
618 toc.removeChild(tocEntriesToRemove[i]);
\r
621 // Rebuild TOC entries.
\r
622 var entries = tocEntries(document.getElementById("content"), toclevels);
\r
623 for (var i = 0; i < entries.length; ++i) {
\r
624 var entry = entries[i];
\r
625 if (entry.element.id == "")
\r
626 entry.element.id = "_toc_" + i;
\r
627 var a = document.createElement("a");
\r
628 a.href = "#" + entry.element.id;
\r
629 a.appendChild(document.createTextNode(entry.text));
\r
630 var div = document.createElement("div");
\r
631 div.appendChild(a);
\r
632 div.className = "toclevel" + entry.toclevel;
\r
633 toc.appendChild(div);
\r
635 if (entries.length == 0)
\r
636 toc.parentNode.removeChild(toc);
\r
640 /////////////////////////////////////////////////////////////////////
\r
641 // Footnotes generator
\r
642 /////////////////////////////////////////////////////////////////////
\r
644 /* Based on footnote generation code from:
\r
645 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
\r
648 footnotes: function () {
\r
649 // Delete existing footnote entries in case we're reloading the footnodes.
\r
651 var noteholder = document.getElementById("footnotes");
\r
655 var entriesToRemove = [];
\r
656 for (i = 0; i < noteholder.childNodes.length; i++) {
\r
657 var entry = noteholder.childNodes[i];
\r
658 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
\r
659 entriesToRemove.push(entry);
\r
661 for (i = 0; i < entriesToRemove.length; i++) {
\r
662 noteholder.removeChild(entriesToRemove[i]);
\r
665 // Rebuild footnote entries.
\r
666 var cont = document.getElementById("content");
\r
667 var spans = cont.getElementsByTagName("span");
\r
670 for (i=0; i<spans.length; i++) {
\r
671 if (spans[i].className == "footnote") {
\r
673 var note = spans[i].getAttribute("data-note");
\r
675 // Use [\s\S] in place of . so multi-line matches work.
\r
676 // Because JavaScript has no s (dotall) regex flag.
\r
677 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
\r
678 spans[i].innerHTML =
\r
679 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
\r
680 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
681 spans[i].setAttribute("data-note", note);
\r
683 noteholder.innerHTML +=
\r
684 "<div class='footnote' id='_footnote_" + n + "'>" +
\r
685 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
\r
686 n + "</a>. " + note + "</div>";
\r
687 var id =spans[i].getAttribute("id");
\r
688 if (id != null) refs["#"+id] = n;
\r
692 noteholder.parentNode.removeChild(noteholder);
\r
694 // Process footnoterefs.
\r
695 for (i=0; i<spans.length; i++) {
\r
696 if (spans[i].className == "footnoteref") {
\r
697 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
\r
698 href = href.match(/#.*/)[0]; // Because IE return full URL.
\r
700 spans[i].innerHTML =
\r
701 "[<a href='#_footnote_" + n +
\r
702 "' title='View footnote' class='footnote'>" + n + "</a>]";
\r
708 install: function(toclevels) {
\r
711 function reinstall() {
\r
712 asciidoc.footnotes();
\r
714 asciidoc.toc(toclevels);
\r
718 function reinstallAndRemoveTimer() {
\r
719 clearInterval(timerId);
\r
723 timerId = setInterval(reinstall, 500);
\r
724 if (document.addEventListener)
\r
725 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
\r
727 window.onload = reinstallAndRemoveTimer;
\r
731 asciidoc.install();
\r
735 <body class="article">
\r
737 <h1>grml-debootstrap(8)</h1>
\r
740 <div class="sect1">
\r
741 <h2 id="_name">Name</h2>
\r
742 <div class="sectionbody">
\r
743 <div class="paragraph"><p>grml-debootstrap - wrapper around debootstrap for installing plain Debian</p></div>
\r
746 <div class="sect1">
\r
747 <h2 id="_synopsis">Synopsis</h2>
\r
748 <div class="sectionbody">
\r
749 <div class="paragraph"><p>grml-debootstrap [ <em>options</em> ]</p></div>
\r
750 <div class="paragraph"><p><span class="image">
\r
751 <img src="images/screenshot.png" alt="Screenshot" />
\r
755 <div class="sect1">
\r
756 <h2 id="_introduction">Introduction</h2>
\r
757 <div class="sectionbody">
\r
758 <div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap and mmdebstrap if you
\r
759 want) for installing a plain Debian system very fast and easy.</p></div>
\r
760 <div class="paragraph"><p>All you have to do is adjust a few variables in the configuration file
\r
761 /etc/debootstrap/config or specify some command line options and invoke
\r
762 grml-debootstrap. If invoked without any configuration modifications or command
\r
763 line options a dialog based front end will be available to control some basic
\r
764 configuration options.</p></div>
\r
765 <div class="paragraph"><p>A plain and base Debian system will be installed on the given device, directory
\r
766 or virtual image file then. Customization of this process is possible as well.</p></div>
\r
767 <div class="admonitionblock">
\r
770 <img src="./images/icons/caution.png" alt="Caution" />
\r
772 <td class="content">The Grml team does not take responsibility for loss of any data!</td>
\r
777 <div class="sect1">
\r
778 <h2 id="_options_and_environment_variables">Options and environment variables</h2>
\r
779 <div class="sectionbody">
\r
780 <div class="dlist"><dl>
\r
781 <dt class="hdlist1">
\r
782 <strong>--arch</strong> <em>architecture</em>
\r
786 Set target architecture you want to install. Defaults to the architecture
\r
787 you are currently running. If you’re running an amd64 kernel and want to
\r
788 deploy an i386 system use this option. Note: deploying amd64 from an i386
\r
789 kernel does <strong>not</strong> work. Example: "<em>--arch i386</em>"
\r
792 <dt class="hdlist1">
\r
793 <strong>--backportrepos</strong>
\r
797 Enable Debian’s Backports repository via the
\r
798 /etc/apt/sources.list.d/backports.list configuration file. This provides the
\r
799 option to install Debian packages from Debian’s backports repository.
\r
802 <dt class="hdlist1">
\r
803 <strong>--bootappend</strong> <em>appendline-for-the-kernel</em>
\r
807 Specify appendline for the kernel.
\r
808 E.g. "<em>pci=nomsi</em>"
\r
811 <dt class="hdlist1">
\r
812 <strong>-c</strong>, <strong>--config</strong> <em>file</em>
\r
816 Use specified configuration file, defaults to /etc/debootstrap/config.
\r
819 <dt class="hdlist1">
\r
820 <strong>--chroot-scripts</strong> <em>directory</em>
\r
824 Execute chroot scripts from specified directory. This allows customisation
\r
825 of the chroot setup, the executable script(s) present in the given directory
\r
826 are executed at the end of the chroot procedure.
\r
827 Default directory: /etc/debootstrap/chroot-scripts/
\r
830 <dt class="hdlist1">
\r
831 <strong>--contrib</strong>
\r
835 Enable the <em>contrib</em> repository in COMPONENTS. By default only
\r
836 the <em>main</em> repository is enabled.
\r
839 <dt class="hdlist1">
\r
840 <strong>-d</strong>, <strong>--confdir</strong> <em>path</em>
\r
844 Place of configuration files for debootstrap, defaults to /etc/debootstrap.
\r
847 <dt class="hdlist1">
\r
848 <strong>--debconf</strong> <em>file</em>
\r
852 Use specified file for preseeding Debian packages instead of using
\r
853 the default <confdir>/debconf-selections.
\r
856 <dt class="hdlist1">
\r
857 <strong>--debopt</strong> <em>params</em>
\r
861 Extra parameters passed to the debootstrap command.
\r
864 <dt class="hdlist1">
\r
865 <strong>--debug</strong>
\r
869 Execute in very verbose way. Useful for debugging possible problems
\r
870 with grml-debootstrap or identify what’s actually executed.
\r
873 <dt class="hdlist1">
\r
874 <strong>--defaultinterfaces</strong>
\r
878 Install a default /etc/network/interfaces file (enabling DHCP for all local
\r
879 Ethernet, WLAN and WWAN interfaces using predictable network interface names
\r
880 and using eth0 as traditional interface name for backward compatibility)
\r
881 instead of taking over config from host system.
\r
882 This option is automatically enabled when using --vm or --vmfile.
\r
885 <dt class="hdlist1">
\r
886 <strong>--efi</strong> <em>device</em>
\r
890 Partition where EFI boot manager should be installed to. If the
\r
891 specified device doesn’t use a FAT filesystem yet grml-debootstrap
\r
892 automatically creates the filesystem. If a FAT filesystem is already
\r
893 present the filesystem creation is skipped. Please ensure that it’s
\r
894 a valid FAT32 filesystem and the partition has the <em>boot</em> and <em>esp</em>
\r
895 flags enabled. This option requires EFI support on the running system
\r
896 and the option is NOT supported for Virtual Machine deployments.
\r
899 <dt class="hdlist1">
\r
900 <strong>--filesystem</strong> <em>filesystem</em>
\r
904 Filesystem that should be created when installing to a partition.
\r
905 If unset defaults to ext4. Valid values are all filesystems that
\r
906 can be created through mkfs.<em>filesystem</em>.
\r
909 <dt class="hdlist1">
\r
910 <strong>--force</strong>
\r
914 Skip user acknowledgement and do not prompt for user input.
\r
917 <dt class="hdlist1">
\r
918 <strong>--grmlrepos</strong>
\r
922 Enable Grml.org’s Debian repository (<a href="http://deb.grml.org/">http://deb.grml.org/</a>) via the
\r
923 /etc/apt/sources.list.d/grml.list configuration file. This provides the
\r
924 option to install Debian packages from Grml’s repository.
\r
927 <dt class="hdlist1">
\r
928 <strong>--grub</strong> <em>device</em>
\r
932 Device where grub should be installed to. Note that only the MBR (master
\r
933 boot record) can be used (/dev/sda, /dev/sdb,…). Partitions (like
\r
934 /dev/sda1, /dev/sdb2,…) are NOT supported because grub2 doesn’t support
\r
935 installation into the PBR (partition boot record) anymore. Usage example:
\r
936 <em>--grub /dev/sda</em>. Note: just do not set this option to avoid installation
\r
940 <dt class="hdlist1">
\r
941 <strong>--help</strong>, <strong>-h</strong>
\r
945 Show summary of options and exit.
\r
948 <dt class="hdlist1">
\r
949 <strong>--hostname</strong> <em>hostname</em>
\r
953 Use specified hostname instead of the default (being $HOSTNAME or if unset <em>grml</em>).
\r
956 <dt class="hdlist1">
\r
957 <strong>-i</strong>, <strong>--iso</strong> <em>/mntpoint</em>
\r
961 Specify mount point where you have a Debian ISO mounted loopback.
\r
962 Using this option instead of the mirror option gives you the possibility
\r
963 to install the base-system without network access. Make sure you
\r
964 mounted the according Debian-ISO to the given <em>/mntpoint</em>. See section
\r
965 <em>Usage examples</em> for a demonstration.
\r
968 <dt class="hdlist1">
\r
969 <strong>--keep_src_list</strong>
\r
973 Do not overwrite user provided /etc/apt/sources.list.
\r
976 <dt class="hdlist1">
\r
977 <strong>-m</strong>, <strong>--mirror</strong> <em>URL</em>
\r
981 Specify mirror which should be used for apt-get/aptitude.
\r
982 Corresponding with configuration variable MIRROR.
\r
985 <dt class="hdlist1">
\r
986 <strong>--nodebootstrap</strong>
\r
990 Skip debootstrap, only do configuration to the target.
\r
993 <dt class="hdlist1">
\r
994 <strong>--nointerfaces</strong>
\r
998 Do not copy /etc/network/interfaces from host system to the target.
\r
1001 <dt class="hdlist1">
\r
1002 <strong>--nokernel</strong>
\r
1006 Skip installation of default kernel images. This option might be
\r
1007 interesting for you if you want a Debian system which doesn’t
\r
1008 need to provide regular boot, e.g. a system which provides
\r
1009 ISOs for booting via GRUB using grml-rescueboot.
\r
1012 <dt class="hdlist1">
\r
1013 <strong>--non-free</strong>
\r
1017 Enable the <em>non-free</em> repository in COMPONENTS. By default only
\r
1018 the <em>main</em> repository is enabled.
\r
1021 <dt class="hdlist1">
\r
1022 <strong>--nopackages</strong>
\r
1026 Skip installation of packages defined in /etc/debootstrap/packages.
\r
1029 <dt class="hdlist1">
\r
1030 <strong>--nopassword</strong>
\r
1034 Do not prompt for the root password. Note: Use the <em>--password</em> option if
\r
1035 you want to set the root password during an automatic installation but don’t
\r
1036 want to use the interactive dialog.
\r
1039 <dt class="hdlist1">
\r
1040 <strong>-p</strong>, <strong>--mntpoint</strong> <em>/mntpoint</em>
\r
1044 Specify mount point that should be used for mounting the target system.
\r
1045 Corresponding with configuration variable MNTPOINT.
\r
1046 Note: this option has no effect if option -t is given and represents a
\r
1050 <dt class="hdlist1">
\r
1051 <strong>--packages</strong> <em>file</em>
\r
1055 Use specified file as list for packages that should be installed instead of
\r
1056 the default package list file <confdir>/packages.
\r
1059 <dt class="hdlist1">
\r
1060 <strong>--password</strong> <em>password</em>
\r
1064 Use specified password as password for user root. Use with caution, as your
\r
1065 command line might be visible in the process list and the shell history.
\r
1066 It’s meant for automatic installation only.
\r
1069 <dt class="hdlist1">
\r
1070 <strong>--post-scripts</strong> <em>directory</em>
\r
1074 Execute scripts from specified directory after executing the chroot script.
\r
1075 This allows customisation of the system after the chroot has been set up.
\r
1076 The environment variable $MNTPOINT is available inside the scripts for
\r
1077 direct access of the chroot.
\r
1078 Default directory: /etc/debootstrap/post-scripts/
\r
1081 <dt class="hdlist1">
\r
1082 <strong>--pre-scripts</strong> <em>directory</em>
\r
1086 Execute scripts from specified directory before executing the chroot
\r
1087 script. This allows customisation of the system before the chroot has
\r
1088 been set up. The environment variable $MNTPOINT is available inside the
\r
1089 scripts for direct access of the chroot.
\r
1090 Default directory: /etc/debootstrap/pre-scripts/
\r
1093 <dt class="hdlist1">
\r
1094 <strong>-r</strong>, <strong>--release</strong> <em>releasename</em>
\r
1098 Specify release of new Debian system. Supported releases names: lenny,
\r
1099 squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration
\r
1100 variable RELEASE. Default release: buster
\r
1103 <dt class="hdlist1">
\r
1104 <strong>--remove-configs</strong>
\r
1108 Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed
\r
1109 system. Useful for reproducible builds or if you don’t want to leak information.
\r
1112 <dt class="hdlist1">
\r
1113 <strong>--sshcopyid</strong>
\r
1117 Use locally available public keys to authorise root login on the target system.
\r
1118 Similar to ssh-copy-id(1) (without the -i option) it checks if <code>ssh-add -L</code>
\r
1119 provides any output, and if so those keys are appended to
\r
1120 <em>/root/.ssh/authorized_keys</em> (creating the file and directory (with mode 0700)).
\r
1123 <dt class="hdlist1">
\r
1124 <strong>-t</strong>, <strong>--target</strong> <em>target</em>
\r
1128 Target partition (/dev/…) or directory (anything else without /dev at the
\r
1132 <dt class="hdlist1">
\r
1133 <strong>-v</strong>, <strong>--verbose</strong>
\r
1137 Increase verbosity.
\r
1140 <dt class="hdlist1">
\r
1141 <strong>--vm</strong>
\r
1145 Set up a Virtual Machine on an existing block device, which will be
\r
1147 This allows deployment of a Virtual Machine. The options needs to be
\r
1148 combined with the --target option.
\r
1149 This option automatically enables the --defaultinterfaces option.
\r
1150 Usage example: --vm --target /dev/mapper/your-vm-disk
\r
1153 <dt class="hdlist1">
\r
1154 <strong>--vmfile</strong>
\r
1158 Set up a Virtual Machine using a regular file instead of installing to a
\r
1159 partition/block device or directory. This allows deployment of a Virtual
\r
1160 Machine. The options needs to be combined with the --target option
\r
1161 (<em>qemu-img create -f raw …</em> is executed on the specified target).
\r
1162 This option automatically enables the --defaultinterfaces option.
\r
1163 Usage example: --vmfile --target /mnt/sda1/qemu.img
\r
1166 <dt class="hdlist1">
\r
1167 <strong>--vmsize</strong> <em>size</em>
\r
1171 Use specified size for size of Virtual Machine disk file. If not specified it
\r
1172 defaults to 2G (being 2GB). Syntax as supported by qemu-img (see manpage
\r
1173 qemu-img(1) for details.
\r
1174 Usage example: --vmsize 3G
\r
1177 <dt class="hdlist1">
\r
1178 <strong>-V</strong>, <strong>--version</strong>
\r
1182 Show version of program and exit.
\r
1186 <div class="admonitionblock">
\r
1189 <img src="./images/icons/warning.png" alt="Warning" />
\r
1191 <td class="content">the command line parsing of grml-debootstrap usually does not validate
\r
1192 the provided arguments for the command line options. Please be careful and check
\r
1193 docs and /etc/debootstrap/config for further information.</td>
\r
1198 <div class="sect1">
\r
1199 <h2 id="_networking">Networking</h2>
\r
1200 <div class="sectionbody">
\r
1201 <div class="paragraph"><p>By default (that is, if none of the options <strong>--nointerfaces</strong>,
\r
1202 <strong>--defaultinterfaces</strong>, <strong>--vmfile</strong> or <strong>--vm</strong> are given) /etc/network/interfaces
\r
1203 will be copied from the host to the target system.</p></div>
\r
1206 <div class="sect1">
\r
1207 <h2 id="_usage_examples">Usage examples</h2>
\r
1208 <div class="sectionbody">
\r
1209 <div class="literalblock">
\r
1210 <div class="content">
\r
1211 <pre><code>grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>
\r
1213 <div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
\r
1214 <div class="literalblock">
\r
1215 <div class="content">
\r
1216 <pre><code>grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname debian01 --password changeme</code></pre>
\r
1218 <div class="paragraph"><p>Install Debian release stretch on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
\r
1219 Set hostname to <em>debian01</em> and password for user root to <em>changeme</em>.</p></div>
\r
1220 <div class="literalblock">
\r
1221 <div class="content">
\r
1222 <pre><code>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</code></pre>
\r
1224 <div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
\r
1225 <div class="literalblock">
\r
1226 <div class="content">
\r
1227 <pre><code>DEBOOTSTRAP=mmdebstrap grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>
\r
1229 <div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
\r
1230 Use mmdebstrap instead of default debootstrap tool for bootstrapping.</p></div>
\r
1231 <div class="literalblock">
\r
1232 <div class="content">
\r
1233 <pre><code>grml-debootstrap --target /dev/mapper/vg0-rootfs --grub /dev/sda</code></pre>
\r
1235 <div class="paragraph"><p>Install default Debian release (buster) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
\r
1236 <div class="literalblock">
\r
1237 <div class="content">
\r
1238 <pre><code>grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda</code></pre>
\r
1240 <div class="paragraph"><p>Install default Debian release (buster) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
\r
1241 Use /dev/sda1 as EFI partition (requires EFI support in booted system).</p></div>
\r
1242 <div class="literalblock">
\r
1243 <div class="content">
\r
1244 <pre><code>mount /dev/sda1 /data/chroot
\r
1245 grml-debootstrap --target /data/chroot</code></pre>
\r
1247 <div class="paragraph"><p>Install default Debian release (buster) in directory /data/chroot (without any bootloader).</p></div>
\r
1248 <div class="literalblock">
\r
1249 <div class="content">
\r
1250 <pre><code>grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian</code></pre>
\r
1252 <div class="paragraph"><p>Install default Debian release (buster) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
\r
1253 Use specified mirror instead of the default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) one.</p></div>
\r
1254 <div class="literalblock">
\r
1255 <div class="content">
\r
1256 <pre><code>mount /dev/sda1 /mnt/sda1
\r
1257 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img</code></pre>
\r
1259 <div class="paragraph"><p>Install default debian release (buster) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file):</p></div>
\r
1260 <div class="literalblock">
\r
1261 <div class="content">
\r
1262 <pre><code>mount -o loop ./debian-CD-1.iso /media/cdrom
\r
1263 grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso /media/cdrom</code></pre>
\r
1265 <div class="paragraph"><p>Install Debian on /dev/sda1 using the loopback mounted Debian-ISO for the base-system and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
\r
1266 Please notice, that the chroot system requires network access for all packages which are not part of the ISO.</p></div>
\r
1269 <div class="sect1">
\r
1270 <h2 id="_files">Files</h2>
\r
1271 <div class="sectionbody">
\r
1272 <div class="literalblock">
\r
1273 <div class="content">
\r
1274 <pre><code>/etc/debootstrap/config</code></pre>
\r
1276 <div class="paragraph"><p>Main configuration file. Adjust it according to your needs if you want to
\r
1277 execute grml-debootstrap in the non-interactive mode without any special command
\r
1278 line arguments.</p></div>
\r
1279 <div class="literalblock">
\r
1280 <div class="content">
\r
1281 <pre><code>/etc/debootstrap/chroot-script</code></pre>
\r
1283 <div class="paragraph"><p>The script executed within the new Debian system as soon as the main system
\r
1284 has been installed via [c]debootstrap.</p></div>
\r
1285 <div class="literalblock">
\r
1286 <div class="content">
\r
1287 <pre><code>/etc/debootstrap/locale.gen</code></pre>
\r
1289 <div class="paragraph"><p>Defines the default locales used for generating locales via locale-gen.</p></div>
\r
1290 <div class="literalblock">
\r
1291 <div class="content">
\r
1292 <pre><code>/etc/debootstrap/packages</code></pre>
\r
1294 <div class="paragraph"><p>Defines the software packages which should be installed in the new
\r
1295 Debian system by default.</p></div>
\r
1296 <div class="literalblock">
\r
1297 <div class="content">
\r
1298 <pre><code>/etc/debootstrap/extrapackages/</code></pre>
\r
1300 <div class="paragraph"><p>Debian Packages dropped in this directory will be installed into the new Debian
\r
1301 system by default (Control variable: EXTRAPACKAGES)</p></div>
\r
1304 <div class="sect1">
\r
1305 <h2 id="_customization">Customization</h2>
\r
1306 <div class="sectionbody">
\r
1307 <div class="paragraph"><p>You can control execution of grml-debootstrap via adjusting
\r
1308 /etc/debootstrap/config for some main stuff or via setting some selected
\r
1309 variables via command line. The packages which should be installed in the new
\r
1310 Debian system can be defined via the file /etc/debootstrap/packages. If you
\r
1311 want to put existing files to the new Debian system you can place them into the
\r
1312 (by default non-existing) directories boot, etc, share, usr and var in
\r
1313 /etc/debootstrap/. Every existing directory will be copied to the new Debian
\r
1314 system then. If you want to install additional packages that are not available
\r
1315 via the Grml or Debian mirror drop them into /etc/debootstrap/extrapackages and
\r
1316 make sure that EXTRAPACKAGES is set to "yes".</p></div>
\r
1319 <div class="sect1">
\r
1320 <h2 id="_automatic_installation">Automatic installation</h2>
\r
1321 <div class="sectionbody">
\r
1322 <div class="paragraph"><p>If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a
\r
1323 full automatic mode. While this mode isn’t really useful for interactive
\r
1324 execution (just configure /etc/debootstrap/configure or specify the relevant
\r
1325 variables on the command line instead) it is meant for use via boot option
\r
1326 debian2hd on the Grml live system. The boot option debian2hd (more precise: the
\r
1327 kernelname at the bootprompt) supports the following boot options (they
\r
1328 correspond with the command line options mentioned above):</p></div>
\r
1329 <div class="literalblock">
\r
1330 <div class="content">
\r
1331 <pre><code>target=...</code></pre>
\r
1333 <div class="paragraph"><p>The target partition/directory of the new Debian system. Usage example:
\r
1334 target=/dev/sda1</p></div>
\r
1335 <div class="literalblock">
\r
1336 <div class="content">
\r
1337 <pre><code>grub=...</code></pre>
\r
1339 <div class="paragraph"><p>Where do you want to install grub to? Usage example: grub=/dev/sda</p></div>
\r
1340 <div class="literalblock">
\r
1341 <div class="content">
\r
1342 <pre><code>release=...</code></pre>
\r
1344 <div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian buster. Supported
\r
1345 releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch</p></div>
\r
1346 <div class="literalblock">
\r
1347 <div class="content">
\r
1348 <pre><code>mirror=...</code></pre>
\r
1350 <div class="paragraph"><p>Specify mirror which should be used for apt-get/aptitude instead
\r
1351 of the default one (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>).
\r
1352 Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p></div>
\r
1353 <div class="literalblock">
\r
1354 <div class="content">
\r
1355 <pre><code>password=...</code></pre>
\r
1357 <div class="paragraph"><p>Set password of user root without prompting for it but set it to the given
\r
1358 argument. Usage example: password=AiTh5ahn</p></div>
\r
1359 <div class="sect2">
\r
1360 <h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation</h3>
\r
1361 <div class="literalblock">
\r
1362 <div class="content">
\r
1363 <pre><code>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</code></pre>
\r
1365 <div class="paragraph"><p>You have to enter this command line at the bootprompt of the Grml live system.
\r
1366 Please make sure that /dev/sda1 is the partition where you really want to
\r
1367 install your new Debian system.</p></div>
\r
1368 <div class="admonitionblock">
\r
1371 <img src="./images/icons/note.png" alt="Note" />
\r
1373 <td class="content">Automatic installation within booting process is done in grml-autoconfig via
\r
1374 setting environment variable AUTOINSTALL and creation of
\r
1375 /usr/bin/grml-debootstrap_noninteractive with the available and relevant
\r
1376 boot options for grml-debootstrap.</td>
\r
1382 <div class="sect1">
\r
1383 <h2 id="_supported_releases">Supported Releases</h2>
\r
1384 <div class="sectionbody">
\r
1385 <div class="tableblock">
\r
1386 <table rules="all"
\r
1389 cellspacing="0" cellpadding="4">
\r
1390 <caption class="title">Table 1. Current status</caption>
\r
1391 <col width="50%" />
\r
1392 <col width="50%" />
\r
1395 <th align="left" valign="top">Release </th>
\r
1396 <th align="left" valign="top">Status</th>
\r
1401 <td align="left" valign="top"><p class="table">lenny</p></td>
\r
1402 <td align="left" valign="top"><p class="table">works[1]</p></td>
\r
1405 <td align="left" valign="top"><p class="table">squeeze</p></td>
\r
1406 <td align="left" valign="top"><p class="table">works[1]</p></td>
\r
1409 <td align="left" valign="top"><p class="table">wheezy</p></td>
\r
1410 <td align="left" valign="top"><p class="table">works[1]</p></td>
\r
1413 <td align="left" valign="top"><p class="table">jessie</p></td>
\r
1414 <td align="left" valign="top"><p class="table">works</p></td>
\r
1417 <td align="left" valign="top"><p class="table">stretch</p></td>
\r
1418 <td align="left" valign="top"><p class="table">works</p></td>
\r
1421 <td align="left" valign="top"><p class="table">buster</p></td>
\r
1422 <td align="left" valign="top"><p class="table">works</p></td>
\r
1425 <td align="left" valign="top"><p class="table">bullseye</p></td>
\r
1426 <td align="left" valign="top"><p class="table">works[2]</p></td>
\r
1429 <td align="left" valign="top"><p class="table">sid</p></td>
\r
1430 <td align="left" valign="top"><p class="table">works[2]</p></td>
\r
1435 <div class="admonitionblock">
\r
1438 <img src="./images/icons/note.png" alt="Note" />
\r
1440 <td class="content">
\r
1441 <div class="title">lenny/squeeze/wheezy release</div>
\r
1442 <div class="paragraph"><p>[1] Please notice that releases like lenny, squeeze and wheezy are unsupported releases within Debian nowadays.
\r
1443 grml-debootstrap can handle the releases but you really should not use them
\r
1444 anymore unless you really know what you are doing.
\r
1445 Choose the current Debian stable version instead.
\r
1446 See <a href="https://wiki.debian.org/DebianReleases">https://wiki.debian.org/DebianReleases</a> for the list of supported releases.</p></div>
\r
1447 <div class="paragraph"><p>Notice that you need to specify a mirror providing the lenny and squeeze releases, the
\r
1448 default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) doesn’t provide it any longer nowadays.
\r
1449 Set the mirror to e.g. <a href="http://archive.debian.org/debian/">http://archive.debian.org/debian/</a> if you don’t have
\r
1450 your own lenny/squeeze mirror.</p></div>
\r
1451 <div class="paragraph"><p>Older releases might also fail to install when running on top of recent kernel versions,
\r
1452 throwing segfaults during debootstrap. This can be identified by the following messages inside kernel log (check with <em>dmesg</em>):</p></div>
\r
1453 <div class="literalblock">
\r
1454 <div class="content">
\r
1455 <pre><code>dpkg[...] vsyscall attempted with vsyscall=none ip:[...]
\r
1456 dpkg[...]: segfault at [...]</code></pre>
\r
1458 <div class="paragraph"><p>To work around this issue boot your system with the kernel boot option <em>vsyscall=emulate</em>.</p></div>
\r
1459 <div class="paragraph"><p>You also need to specify a filesystem that’s supported by lenny, e.g.
\r
1460 <em>--filesystem ext3</em> since grml-debootstrap’s current default (ext4) isn’t
\r
1461 supported by lenny.</p></div>
\r
1462 <div class="paragraph"><p>Also when debootstrapping lenny on a live system with a kernel version
\r
1463 like "3.16-1-grml-amd64" lenny’s libc will fail to install with:</p></div>
\r
1464 <div class="literalblock">
\r
1465 <div class="content">
\r
1467 /var/lib/dpkg/tmp.ci/preinst: line 265: [: 3.16-1-grml-amd64: integery expression expected
\r
1468 /var/lib/dpkg/tmp.ci/preinst: line 231: 3.16-1-grml-amd64: syntax error: invalid arithemtic operator (error token is ".16-1-grml-amd64")
\r
1469 dpkg: error processing /var/cache/apt/archives/libc6_2.7-18lenny7_amd64.deb (--install):
\r
1470 [....]</code></pre>
\r
1472 <div class="paragraph"><p>To workaround this either debootstrap from a system with an according
\r
1473 kernel version or use the "fake uname" workaround (just google for it).</p></div>
\r
1474 <div class="paragraph"><p>When installing lenny to a new mdraid, grml-debootstrap will use md metadata
\r
1475 format version 0.90. This limits the device to a maximum size of 2TB, but has
\r
1476 the advantage of grub-legacy actually being able to boot from it.</p></div>
\r
1480 <div class="admonitionblock">
\r
1483 <img src="./images/icons/note.png" alt="Note" />
\r
1485 <td class="content">
\r
1486 <div class="title">unstable and testing releases</div>
\r
1487 <div class="paragraph"><p>[2] Please notice that Debian/testing and Debian/unstable (sid) might
\r
1488 not be always installable due to their nature. What <em>might</em> work instead is
\r
1489 deploying a stable release and upgrade it after installation finished.</p></div>
\r
1495 <div class="sect1">
\r
1496 <h2 id="_bugs">Bugs</h2>
\r
1497 <div class="sectionbody">
\r
1498 <div class="paragraph"><p>Please report bugs towards <a href="https://github.com/grml/grml-debootstrap/issues">https://github.com/grml/grml-debootstrap/issues</a></p></div>
\r
1501 <div class="sect1">
\r
1502 <h2 id="_see_also">See also</h2>
\r
1503 <div class="sectionbody">
\r
1504 <div class="paragraph"><p>debootstrap (8), cdebootstrap (1), mmdebstrap(1).</p></div>
\r
1507 <div class="sect1">
\r
1508 <h2 id="_author">Author</h2>
\r
1509 <div class="sectionbody">
\r
1510 <div class="paragraph"><p>Michael Prokop <<a href="mailto:mika@grml.org">mika@grml.org</a>></p></div>
\r
1514 <div id="footnotes"><hr /></div>
\r
1516 <div id="footer-text">
\r
1518 2019-12-13 13:06:15 UTC
\r