1DEBOOTSTRAP(8)              Debian GNU/Linux manual             DEBOOTSTRAP(8)
2
3
4

NAME

6       debootstrap - Bootstrap a basic Debian system
7

SYNOPSIS

9       debootstrap [OPTION...]  SUITE TARGET [MIRROR [SCRIPT]]
10
11       debootstrap [OPTION...]  --second-stage
12

DESCRIPTION

14       debootstrap bootstraps a basic Debian system of SUITE (eg, sarge, etch,
15       lenny, sid) into TARGET from MIRROR by running SCRIPT.  MIRROR  can  be
16       an  http:// URL, a file:/// URL, or an ssh:/// URL.  Notice that file:/
17       URLs are translated to file:/// (correct scheme as described in RFC1738
18       for  local filenames), and file:// will not work.  ssh://USER@HOST/PATH
19       URLs are retrieved using scp; use of ssh-agent or similar  is  strongly
20       recommended.
21
22       Debootstrap  can be used to install Debian in a system without using an
23       installation disk but can also be used to run a different Debian flavor
24       in  a  chroot  environment.  This  way  you can create a full (minimal)
25       Debian installation which can be used for  testing  purposes  (see  the
26       EXAMPLES  section).   If  you  are looking for a chroot system to build
27       packages please take a look at pbuilder.
28

OPTIONS

30       --arch ARCH
31              Set the target architecture (use if dpkg isn't  installed).  See
32              also --foreign.
33
34       --include=alpha,beta
35              Comma separated list of packages which will be added to download
36              and extract lists.
37
38       --exclude=alpha,beta
39              Comma separated list of packages  which  will  be  removed  from
40              download  and  extract lists. WARNING: you can and probably will
41              exclude essential packages, be careful using this option.
42
43       --components=alpha,beta
44              Use packages from the listed components of the archive.
45
46       --no-resolve-deps
47              By default, debootstrap will attempt  to  automatically  resolve
48              any  missing  dependencies,  warning if any are found. Note that
49              this is not a complete dependency resolve in the sense  of  dpkg
50              or  apt,  and  that  it is far better to specify the entire base
51              system than rely on this option. With this option set, this  be‐
52              haviour is disabled.
53
54       --variant=buildd|fakechroot
55              Name  of  the  bootstrap  script variant to use.  Currently, the
56              variant supported are buildd, which installs the build-essential
57              packages into TARGET and fakechroot, which installs the packages
58              without root privileges.  The default, with no --variant=X argu‐
59              ment, is to create a base Debian installation in TARGET.
60
61       --keyring=KEYRING
62              Download  signatures  for retrieved Release files and check them
63              against KEYRING.  By default, Release file  signatures  are  not
64              checked.
65
66       --verbose
67              Produce more info about downloading.
68
69       --print-debs
70              Print the packages to be installed, and exit. Note that a TARGET
71              directory must be specified so debootstrap can download Packages
72              files  to  determine  which packages should be installed, and to
73              resolve dependencies.  The  TARGET  directory  will  be  deleted
74              unless --keep-debootstrap-dir is specified.
75
76       --download-only
77              Download packages, but don't perform installation
78
79       --foreign
80              Do  the  initial unpack phase of bootstrapping only, for example
81              if the target architecture does not match the host architecture.
82              A  copy  of  debootstrap sufficient for completing the bootstrap
83              process will be installed  as  /debootstrap/debootstrap  in  the
84              target filesystem.
85
86       --second-stage
87              Complete  the  bootstrapping process. Other arguments are gener‐
88              ally not needed.
89
90       --second-stage-target DIR
91              Run second stage in a subdirectory instead of root. (can be used
92              to create a foreign chroot) (requires --second-stage)
93
94       --keep-debootstrap-dir
95              Don't delete the /debootstrap directory in the target after com‐
96              pleting the installation.
97
98       --unpack-tarball FILE
99              Acquire .debs from tarball FILE instead of downloading via http
100
101       --make-tarball FILE
102              Instead of bootstrapping, make a tarball (written  to  FILE)  of
103              the downloaded packages.  The resulting tarball may be passed to
104              a later --unpack-tarball.
105
106       --boot-floppies
107              Used for internal purposes by boot-floppies
108
109       --debian-installer
110              Used for internal purposes by the debian-installer
111

EXAMPLE

113       To setup a sarge system:
114
115       # debootstrap sarge ./sarge-chroot http://ftp.debian.org/debian
116
117       # debootstrap sarge ./sarge-chroot file:///PATH_TO_LOCAL_MIRROR/debian
118
119       Full process to create a complete Debian installation  of  sid  (unsta‐
120       ble):
121
122            main # cd / ; mkdir /sid-root
123            main # debootstrap sid /sid-root http://ftp.debian.org/debian/
124            [ ... watch it download the whole system ]
125            main # echo "proc /sid-root/proc proc none 0 0" >> /etc/fstab
126            main # mount proc /sid-root/proc -t proc
127            main # cp /etc/hosts /sid-root/etc/hosts
128            main # chroot /sid-root /bin/bash
129            chroot # dselect
130            [ you may use aptitude, install mc and vim ... ]
131             main # echo "8:23:respawn:/usr/sbin/chroot /sid-root " \
132                    "/sbin/getty 38400 tty8"  >> /etc/inittab
133            [ define a login tty that will use this system ]
134             main # init q
135            [ reload init ]
136
137       Note that you will generally need a recent version of debootstrap to do
138       this; the version currently in stable will generally have stopped work‐
139       ing due to changes to unstable shortly after the last release.
140

AUTHOR

142       debootstrap  was  written by Anthony Towns <ajt@debian.org>.  This man‐
143       page was written by Matt Kraai <kraai@debian.org>.
144
145
146
147Debian Project                    2001-04-27                    DEBOOTSTRAP(8)
Impressum