NAME¶grml-debootstrap - wrapper around debootstrap for installing plain Debian
SYNOPSIS¶grml-debootstrap [ options ]
INTRODUCTION¶grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap and mmdebstrap if you want) for installing a plain Debian system very fast and easy.
All you have to do is adjust a few variables in the configuration file /etc/debootstrap/config or specify some command line options and invoke grml-debootstrap. If invoked without any configuration modifications or command line options a dialog based front end will be available to control some basic configuration options.
A plain and base Debian system will be installed on the given device, directory or virtual image file then. Customization of this process is possible as well.
The Grml team does not take responsibility for loss of any data!
OPTIONS AND ENVIRONMENT VARIABLES¶--arch architecture
-c, --config file
-d, --confdir path
-i, --iso /mntpoint
-m, --mirror URL
-p, --mntpoint /mntpoint
-r, --release releasename
-t, --target target
the command line parsing of grml-debootstrap usually does not validate the provided arguments for the command line options. Please be careful and check docs and /etc/debootstrap/config for further information.
NETWORKING¶By default (that is, if none of the options --nointerfaces, --defaultinterfaces, --vmfile or --vm are given) /etc/network/interfaces will be copied from the host to the target system.
grml-debootstrap --target /dev/sda1 --grub /dev/sda
Install default Debian release (bullseye) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname debian01 --password changeme
Install Debian release stretch on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Set hostname to debian01 and password for user root to changeme.
grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid
Install Debian unstable/sid on /dev/sda6 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
DEBOOTSTRAP=mmdebstrap grml-debootstrap --target /dev/sda1 --grub /dev/sda
Install default Debian release (bullseye) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use mmdebstrap instead of default debootstrap tool for bootstrapping.
grml-debootstrap --target /dev/mapper/vg0-rootfs --grub /dev/sda
Install default Debian release (bullseye) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda
Install default Debian release (bullseye) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use /dev/sda1 as EFI partition (requires EFI support in booted system).
mount /dev/sda1 /data/chroot grml-debootstrap --target /data/chroot
Install default Debian release (bullseye) in directory /data/chroot (without any bootloader).
grml-debootstrap --target /dev/sda3 --grub /dev/sda --mirror ftp://ftp.tugraz.at/mirror/debian
Install default Debian release (bullseye) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda. Use specified mirror instead of the default (http://deb.debian.org/debian) one.
mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img
Install default debian release (bullseye) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file):
mount -o loop ./debian-CD-1.iso /media/cdrom grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso /media/cdrom
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. Please notice, that the chroot system requires network access for all packages which are not part of the ISO.
Main configuration file. Adjust it according to your needs if you want to execute grml-debootstrap in the non-interactive mode without any special command line arguments.
The script executed within the new Debian system as soon as the main system has been installed via [c]debootstrap.
Defines the default locales used for generating locales via locale-gen.
Defines the software packages which should be installed in the new Debian system by default.
Debian Packages dropped in this directory will be installed into the new Debian system by default (Control variable: EXTRAPACKAGES)
CUSTOMIZATION¶You can control execution of grml-debootstrap via adjusting /etc/debootstrap/config for some main stuff or via setting some selected variables via command line. The packages which should be installed in the new Debian system can be defined via the file /etc/debootstrap/packages. If you want to put existing files to the new Debian system you can place them into the (by default non-existing) directories boot, etc, share, usr and var in /etc/debootstrap/. Every existing directory will be copied to the new Debian system then. If you want to install additional packages that are not available via the Grml or Debian mirror drop them into /etc/debootstrap/extrapackages and make sure that EXTRAPACKAGES is set to "yes".
AUTOMATIC INSTALLATION¶If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a full automatic mode. While this mode isn’t really useful for interactive execution (just configure /etc/debootstrap/configure or specify the relevant variables on the command line instead) it is meant for use via boot option debian2hd on the Grml live system. The boot option debian2hd (more precise: the kernelname at the bootprompt) supports the following boot options (they correspond with the command line options mentioned above):
The target partition/directory of the new Debian system. Usage example: target=/dev/sda1
Where do you want to install grub to? Usage example: grub=/dev/sda
Specify release of new Debian system. Defaults to Debian bullseye. Supported releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch
Set password of user root without prompting for it but set it to the given argument. Usage example: password=AiTh5ahn
Usage example for automatic installation¶
debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar
You have to enter this command line at the bootprompt of the Grml live system. Please make sure that /dev/sda1 is the partition where you really want to install your new Debian system.
Automatic installation within booting process is done in grml-autoconfig via setting environment variable AUTOINSTALL and creation of /usr/bin/grml-debootstrap_noninteractive with the available and relevant boot options for grml-debootstrap.
SUPPORTED RELEASES¶Table 1. Current status
 Please notice that releases like lenny, squeeze and wheezy are unsupported releases within Debian nowadays. grml-debootstrap can handle the releases but you really should not use them anymore unless you really know what you are doing. Choose the current Debian stable version instead. See https://wiki.debian.org/DebianReleases for the list of supported releases.
Notice that you need to specify a mirror providing the lenny and squeeze releases, the default (http://deb.debian.org/debian) doesn’t provide it any longer nowadays. Set the mirror to e.g. http://archive.debian.org/debian/ if you don’t have your own lenny/squeeze mirror.
Older releases might also fail to install when running on top of recent kernel versions, throwing segfaults during debootstrap. This can be identified by the following messages inside kernel log (check with dmesg):
dpkg[...] vsyscall attempted with vsyscall=none ip:[...] dpkg[...]: segfault at [...]
To work around this issue boot your system with the kernel boot option vsyscall=emulate.
You also need to specify a filesystem that’s supported by lenny, e.g. --filesystem ext3 since grml-debootstrap’s current default (ext4) isn’t supported by lenny.
Also when debootstrapping lenny on a live system with a kernel version like "3.16-1-grml-amd64" lenny’s libc will fail to install with:
[...] /var/lib/dpkg/tmp.ci/preinst: line 265: [: 3.16-1-grml-amd64: integery expression expected /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") dpkg: error processing /var/cache/apt/archives/libc6_2.7-18lenny7_amd64.deb (--install): [....]
To workaround this either debootstrap from a system with an according kernel version or use the "fake uname" workaround (just google for it).
When installing lenny to a new mdraid, grml-debootstrap will use md metadata format version 0.90. This limits the device to a maximum size of 2TB, but has the advantage of grub-legacy actually being able to boot from it.
unstable and testing releases
 Please notice that Debian/testing and Debian/unstable (sid) might not be always installable due to their nature. What might work instead is deploying a stable release and upgrade it after installation finished.
BUGS¶Please report bugs towards https://github.com/grml/grml-debootstrap/issues
SEE ALSO¶debootstrap (8), cdebootstrap (1), mmdebstrap(1).
AUTHOR¶Michael Prokop <email@example.com>