Introduction
------------
-grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you
+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 frontend will be available to control some basic
+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
*--backportrepos*::
- Enable Debian's Backports repository (http://backports.debian.org/) via the
+ Enable Debian's Backports repository via the
/etc/apt/sources.list.d/backports.list configuration file. This provides the
option to install Debian packages from Debian's backports repository.
*-r*, *--release* _releasename_::
Specify release of new Debian system. Supported releases names: lenny,
- squeeze, wheezy, jessie, stretch and sid. Corresponding with configuration
- variable RELEASE. Default release: stretch
+ squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration
+ variable RELEASE. Default release: buster
*--remove-configs*::
grml-debootstrap --target /dev/sda1 --grub /dev/sda
-Install default Debian release (stretch) on /dev/sda1 and install bootmanager
-Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.
+Install default Debian release (buster) on /dev/sda1 and install bootmanager
+GRUB in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.
+
+ grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname foobar --password changeme
+
+Install Debian release stretch on /dev/sda1 and install bootmanager
+GRUB in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.
+Set hostname to 'foobar' and password for user root to 'changeme'.
grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid
-Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR
+Install Debian unstable/sid on /dev/sda6, install bootmanager GRUB in MBR
(master boot record) of /dev/sda and use /dev/sda6 as system partition.
mount /dev/sda1 /data/chroot
grml-debootstrap --target /data/chroot
-Install default Debian release (stretch) in directory /data/chroot (without
+Install default Debian release (buster) 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 (stretch) on /dev/sda3 and install bootmanager
-Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
-Use specified mirror instead of the default (http://httpredir.debian.org/debian) one.
+Install default Debian release (buster) on /dev/sda3 and install bootmanager
+GRUB in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
+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 (stretch) in a Virtual Machine file with
-3GB disk size (including Grub as bootmanager in MBR of the virtual disk file):
+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):
mount -o loop /mnt/sda6/debian-CD-1.iso /mnt/iso
grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/
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
+for the base-system and install bootmanager GRUB in MBR (master boot record) of
/dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot
system requires network access for all packages which are not part of the
ISO.
release=...
-Specify release of new Debian system. Defaults to Debian stretch. Supported
-releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: release=sid
+Specify release of new Debian system. Defaults to Debian buster. Supported
+releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch
mirror=...
Specify mirror which should be used for apt-get/aptitude instead
-of the default one (http://httpredir.debian.org/debian).
+of the default one (http://deb.debian.org/debian).
Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian
password=...
include::releasetable.txt[]
[NOTE]
-.lenny/squeeze release
+.lenny/squeeze/wheezy release
================================================================================
-[1] Please notice that lenny and squeeze are unsupported releases within Debian nowadays.
+[1] 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.
+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/squeeze releases, the
-default (http://httpredir.debian.org/debian) doesn't provide it any longer nowadays.
+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.
Bugs
----
-Probably. Please send bugreports to Michael Prokop <mika@grml.org>.
+Please report bugs towards https://github.com/grml/grml-debootstrap/issues
See also
--------
-debootstrap (8), cdebootstrap (1).
+debootstrap (8), cdebootstrap (1), mmdebstrap(1).
Author
------
projects / grml-debootstrap.git / blobdiff