1DEBOOTSTRAP(8) Debian GNU/Linux manual DEBOOTSTRAP(8)
2
3
4
6 debootstrap - Bootstrap a basic Debian system
7
9 debootstrap [OPTION...] SUITE TARGET [MIRROR [SCRIPT]]
10
11 debootstrap [OPTION...] --second-stage
12
14 debootstrap bootstraps a basic Debian system of SUITE into TARGET from
15 MIRROR by running SCRIPT. MIRROR can be an http:// or https:// URL, a
16 file:/// URL, or an ssh:/// URL.
17
18 The SUITE may be a release code name (eg, sid, stretch, jessie) or a
19 symbolic name (eg, unstable, testing, stable, oldstable)
20
21 Notice that file:/ URLs are translated to file:/// (correct scheme as
22 described in RFC1738 for local filenames), and file:// will not work.
23 ssh://USER@HOST/PATH URLs are retrieved using scp; use of ssh-agent or
24 similar is strongly recommended.
25
26 Debootstrap can be used to install Debian in a system without using an
27 installation disk but can also be used to run a different Debian flavor
28 in a chroot environment. This way you can create a full (minimal) De‐
29 bian installation which can be used for testing purposes (see the EXAM‐
30 PLES section). If you are looking for a chroot system to build pack‐
31 ages please take a look at pbuilder.
32
34 --arch=ARCH
35 Set the target architecture (use if dpkg isn't installed). See
36 also --foreign.
37
38 --include=alpha,beta
39 Comma separated list of packages which will be added to download
40 and extract lists.
41
42 --exclude=alpha,beta
43 Comma separated list of packages which will be removed from
44 download and extract lists. WARNING: you can and probably will
45 exclude essential packages, be careful using this option.
46
47 --extra-suites=alpha,beta
48 Also use packages from the listed suites of the archive.
49
50 --components=alpha,beta
51 Use packages from the listed components of the archive.
52
53 --no-resolve-deps
54 By default, debootstrap will attempt to automatically resolve
55 any missing dependencies, warning if any are found. Note that
56 this is not a complete dependency resolve in the sense of dpkg
57 or apt, and that it is far better to specify the entire base
58 system than rely on this option. With this option set, this be‐
59 haviour is disabled.
60
61 --log-extra-deps
62 If you want to record additional dependencies when resolving
63 package dependencies, set this option to track them through de‐
64 bootstrap.log.
65
66 --variant=minbase|buildd|fakechroot
67 Name of the bootstrap script variant to use. Currently, the
68 variants supported are minbase, which only includes required
69 packages and apt; buildd, which installs the build-essential
70 packages and fakechroot, which installs the packages without
71 root privileges. The default, with no --variant=X argument, is
72 to create a base Debian installation with all packages of prior‐
73 ity required and important, including apt.
74
75 --merged-usr
76 Create /{bin,sbin,lib}/ symlinks pointing to their counterparts
77 in /usr/. (Default for most variants.)
78
79 --no-merged-usr
80 Do not create /{bin,sbin,lib}/ symlinks pointing to their coun‐
81 terparts in /usr/. (Default for the buildd variant.)
82
83 --keyring=KEYRING
84 Override the default keyring for the distribution being boot‐
85 strapped, and use KEYRING to check signatures of retrieved Re‐
86 lease files.
87
88 --no-check-gpg
89 Disables checking gpg signatures of retrieved Release files.
90
91 --force-check-gpg
92 Forces checking Release file signatures, disabling automatic
93 fallback to HTTPS in case of a missing keyring. Incompatible
94 with the previous option.
95
96 --verbose
97 Produce more info about downloading.
98
99 --print-debs
100 Print the packages to be installed, and exit. Note that an
101 empty or non-existing TARGET directory must be specified so that
102 debootstrap can download Packages files to determine which pack‐
103 ages should be installed, and to resolve dependencies. The TAR‐
104 GET directory will be deleted unless --keep-debootstrap-dir is
105 specified.
106
107 --download-only
108 Download packages, but don't perform installation.
109
110 --foreign
111 Do the initial unpack phase of bootstrapping only, for example
112 if the target architecture does not match the host architecture.
113 A copy of debootstrap sufficient for completing the bootstrap
114 process will be installed as /debootstrap/debootstrap in the
115 target filesystem. You can run it with the --second-stage op‐
116 tion to complete the bootstrapping process.
117
118 --second-stage
119 Complete the bootstrapping process. Other arguments are gener‐
120 ally not needed.
121
122 --second-stage-target=DIR
123 Run second stage in a subdirectory instead of root. (can be used
124 to create a foreign chroot) (requires --second-stage)
125
126 --keep-debootstrap-dir
127 Don't delete the /debootstrap directory in the target after com‐
128 pleting the installation.
129
130 --cache-dir=DIR
131 Cache .deb files under directory. It should be an absolute path.
132
133 --unpack-tarball=FILE
134 Acquire .debs from gzipped tarball FILE (specified with absolute
135 path) instead of downloading via HTTP(S).
136
137 --make-tarball=FILE
138 Instead of bootstrapping, make a gzipped tarball (written to
139 FILE) of the downloaded packages. The resulting tarball may be
140 passed to a later --unpack-tarball. Note that an empty or non-
141 existing TARGET directory must be specified so that debootstrap
142 can download packages to prepare the tarball. The TARGET direc‐
143 tory will be deleted unless --keep-debootstrap-dir is specified.
144
145 --debian-installer
146 Used for internal purposes by the debian-installer
147
148 --extractor=TYPE
149 Override automatic .deb extractor selection to TYPE. Supported
150 extractors are: dpkg-deb and ar.
151
152 --no-check-certificate
153 Do not check certificate against certificate authorities
154
155 --certificate=FILE
156 Use the client certificate stored in file (PEM)
157
158 --private-key=FILE
159 Read the private key from file
160
161 --inrelease-path
162 Determine the path to the InRelease file of the suite relative
163 to the normal position of an InRelease file
164
166 To setup a stretch system:
167
168 debootstrap stretch ./stretch-chroot http://deb.debian.org/debian
169
170 debootstrap stretch ./stretch-chroot file:///LOCAL_MIRROR/debian
171
172 Full process to create a complete Debian installation of sid (unstable)
173 in a chroot:
174
175 main # debootstrap sid sid-root http://deb.debian.org/debian/
176 [ ... watch it download the whole system ]
177 main # echo "proc sid-root/proc proc defaults 0 0" >> /etc/fstab
178 main # mount proc sid-root/proc -t proc
179 main # echo "sysfs sid-root/sys sysfs defaults 0 0" >> /etc/fstab
180 main # mount sysfs sid-root/sys -t sysfs
181 main # cp /etc/hosts sid-root/etc/hosts
182 main # chroot sid-root /bin/bash
183
185 debootstrap was written by Anthony Towns <ajt@debian.org>. This man‐
186 page was written by Matt Kraai <kraai@debian.org>.
187
188
189
190Debian Project 2001-04-27 DEBOOTSTRAP(8)