You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Mark Hindley f8c417b5d0 Version 1.0.126+nmu1devuan1. 2 months ago
debian Version 1.0.126+nmu1devuan1. 2 months ago
scripts Import 1.0.126+nmu1 upload 6 months ago
Makefile Remove unused variable `DATE` 6 years ago
README Point to salsa repo 4 years ago
TODO TODO: Remove comment about makedev 6 years ago
debootstrap Merge tag '1.0.125' into suites/unstable 7 months ago
debootstrap.8 Import 1.0.126+nmu1 upload 6 months ago
functions Merge tag '1.0.125' into suites/unstable 7 months ago


README for debootstrap

See the manpage for (some) documentation.

Running debootstrap from source

You can run debootstrap from its source tree without installing it. This
can be useful if you want a quick way to make a Debian chroot on another
system, or if you are testing modifications to debootstrap.

First, get the source.

* Either by using git
git clone

* Or by visiting <>
and downloading the tar.gz file

Then in the debootstrap source directory:

export DEBOOTSTRAP_DIR=`pwd`
sudo ./debootstrap stable my-stable-dir

If you are running a multi-stage boot strap (for example for a QEMU
rootfs) you don't even need root:

export DEBOOTSTRAP_DIR=`pwd`
fakeroot ./debootstrap --foreign --arch=armhf testing my-testing-dir

Of course you will need to execute the second stage as root to finish the bootstrap:

(on foreign hardware)
/debootstrap/debootstrap --second-stage


* Cross-strap support - so you can bootstrap a filesystem to the
point where it will successfully boot, and finish installing itself
without having to be running the target architecture or OS yourself.
This means you should be able to run

debootstrap --arch powerpc sarge ./sarge-ppc-chroot ...

on an i386 system, boot a powerpc box with sarge-ppc-chroot as its
root files system, and have it "work". The cross-hurd package does
something similar, and should be replaced by this feature.

* There should be some (better) way of telling debootstrap what "base"
packages you want to install -- this varies between making a chroot,
doing an install, and doing a buildd. Also, some installs want
different base packages (to setup networking, or kernels, eg)


If there's a problem with debootstrap that you need fixed, feel free to do
an NMU to fix it. Usual rules: try not to break anything, and mail the
patch to the BTS. Don't worry about asking first though.

However, note that debootstrap is now team maintained. Anyone in d-i can do
a release without the bother of a NMU.