summaryrefslogtreecommitdiffstats
path: root/debootstrap.8
diff options
context:
space:
mode:
Diffstat (limited to 'debootstrap.8')
-rw-r--r--debootstrap.8206
1 files changed, 206 insertions, 0 deletions
diff --git a/debootstrap.8 b/debootstrap.8
new file mode 100644
index 0000000..3253144
--- /dev/null
+++ b/debootstrap.8
@@ -0,0 +1,206 @@
+.TH DEBOOTSTRAP 8 2001-04-27 "Debian Project" "Debian GNU/Linux manual"
+.SH NAME
+debootstrap \- Bootstrap a basic Debian system
+.SH SYNOPSIS
+.B debootstrap
+.RB [ OPTION\&.\&.\&. ]
+.I SUITE TARGET
+.RI [ MIRROR
+.RI [ SCRIPT ]]
+
+.B debootstrap
+.RB [ OPTION\&.\&.\&. ]
+\-\-second\-stage
+.SH DESCRIPTION
+.B debootstrap
+bootstraps a basic Debian system of
+.I SUITE
+into
+.I TARGET
+from
+.I MIRROR
+by running
+.IR SCRIPT .
+.I MIRROR
+can be an http:// or https:// URL, a file:/// URL, or an ssh:/// URL.
+.PP
+The
+.I SUITE
+may be a release code name (eg, sid, stretch, jessie)
+or a symbolic name (eg, unstable, testing, stable, oldstable)
+.PP
+Notice that file:/ URLs are translated to file:/// (correct scheme as
+described in RFC1738 for local filenames), and file:// will \fBnot\fR work.
+ssh://USER@HOST/PATH URLs are retrieved using
+.BR scp ;
+use of
+.B ssh\-agent
+or similar is strongly recommended.
+.PP
+\fBDebootstrap\fR can be used to install Debian in a system without using an
+installation disk but can also be used to run a different Debian flavor in a \fBchroot\fR
+environment.
+This way you can create a full (minimal) Debian installation which
+can be used for testing purposes (see the \fBEXAMPLES\fR section).
+If you are looking for a chroot system to build packages please take a look at
+\fBpbuilder\fR.
+.SH "OPTIONS"
+.PP
+.IP "\fB\-\-arch=ARCH\fP"
+Set the target architecture (use if dpkg isn't installed).
+See also \-\-foreign.
+.IP
+.IP "\fB\-\-include=alpha,beta\fP"
+Comma separated list of packages which will be added to download and extract
+lists.
+.IP
+.IP "\fB\-\-exclude=alpha,beta\fP"
+Comma separated list of packages which will be removed from download and
+extract lists.
+WARNING: you can and probably will exclude essential packages, be
+careful using this option.
+.IP
+.IP "\fB\-\-extra-suites=alpha,beta\fP"
+Also use packages from the listed suites of the archive.
+.IP
+.IP "\fB\-\-components=alpha,beta\fP"
+Use packages from the listed components of the archive.
+.IP
+.IP "\fB\-\-no\-resolve\-deps\fP"
+By default, debootstrap will attempt to automatically resolve any missing
+dependencies, warning if any are found.
+Note that this is not a complete dependency resolve in the sense of dpkg
+or apt, and that it is far better to specify the entire base system than
+rely on this option.
+With this option set, this behaviour is disabled.
+.IP
+.IP "\fB\-\-log\-extra\-deps\fP"
+If you want to record additional dependencies when resolving package dependencies,
+set this option to track them through debootstrap.log.
+.IP
+.IP "\fB\-\-variant=minbase|buildd|fakechroot\fP"
+Name of the bootstrap script variant to use.
+Currently, the variants supported are minbase, which only includes
+\fIrequired\fR packages and apt; buildd, which installs the build-essential
+packages and fakechroot, which installs the packages without root privileges.
+The default, with no \fB\-\-variant=X\fP argument, is to create a
+base Debian installation with all packages of priority \fIrequired\fR and
+\fIimportant\fR, including apt.
+.IP
+.IP "\fB\-\-merged-usr\fP"
+Create /{bin,sbin,lib}/ symlinks pointing to their counterparts in /usr/.
+(Default for most variants and suites.)
+.IP
+.IP "\fB\-\-no-merged-usr\fP"
+Do not create /{bin,sbin,lib}/ symlinks pointing to their counterparts in /usr/.
+(Default for the buildd variant of Debian 12 'bookworm' or older, and all
+variants of Debian 9 'stretch' or older.)
+.IP
+.IP "\fB\-\-keyring=KEYRING\fP"
+Override the default keyring for the distribution being bootstrapped,
+and use
+.IR KEYRING
+to check signatures of retrieved Release files.
+.IP
+.IP "\fB\-\-no-check-gpg\fP"
+Disables checking gpg signatures of retrieved Release files.
+.IP
+.IP "\fB\-\-force-check-gpg\fP"
+Forces checking Release file signatures, disabling automatic fallback to
+HTTPS in case of a missing keyring. Incompatible with the previous option.
+.IP
+.IP "\fB\-\-verbose\fP"
+Produce more info about downloading.
+.IP
+.IP "\fB\-\-print\-debs\fP"
+Print the packages to be installed, and exit.
+Note that an empty or non-existing TARGET directory must be specified so
+that debootstrap can download Packages files to determine which packages
+should be installed, and to resolve dependencies. The TARGET directory
+will be deleted unless \-\-keep\-debootstrap\-dir is specified.
+.IP
+.IP "\fB\-\-download\-only\fP"
+Download packages, but don't perform installation.
+.IP
+.IP "\fB\-\-foreign\fP"
+Do the initial unpack phase of bootstrapping only, for example if the
+target architecture does not match the host architecture.
+A copy of debootstrap sufficient for completing the bootstrap process
+will be installed as /debootstrap/debootstrap in the target filesystem.
+You can run it with the \fB\-\-second\-stage\fP option to complete the
+bootstrapping process.
+.IP
+.IP "\fB\-\-second\-stage\fP"
+Complete the bootstrapping process.
+Other arguments are generally not needed.
+.IP
+.IP "\fB\-\-second\-stage\-target=DIR\fP"
+Run second stage in a subdirectory instead of root. (can be used to create
+a foreign chroot) (requires \-\-second\-stage)
+.IP
+.IP "\fB\-\-keep\-debootstrap\-dir\fP"
+Don't delete the /debootstrap directory in the target after completing the
+installation.
+.IP
+.IP "\fB\-\-cache\-dir=DIR\fP"
+Cache .deb files under directory. It should be an absolute path.
+.IP
+.IP "\fB\-\-unpack\-tarball=FILE\fP"
+Acquire .debs from gzipped tarball FILE (specified with absolute path)
+instead of downloading via HTTP(S).
+.IP
+.IP "\fB\-\-make\-tarball=FILE\fP"
+Instead of bootstrapping, make a gzipped tarball (written to FILE) of the
+downloaded packages.
+The resulting tarball may be passed to a later
+.BR \-\-unpack\-tarball .
+Note that an empty or non-existing TARGET directory must be specified so
+that debootstrap can download packages to prepare the tarball. The TARGET
+directory will be deleted unless \-\-keep\-debootstrap\-dir is specified.
+.IP
+.IP "\fB\-\-debian\-installer\fP"
+Used for internal purposes by the debian-installer
+.IP
+.IP "\fB\-\-extractor=TYPE\fP"
+Override automatic .deb extractor selection to
+.IR TYPE .
+Supported extractors are: dpkg-deb and ar.
+.IP
+.IP "\fB\-\-no\-check\-certificate\fP"
+Do not check certificate against certificate authorities
+.IP
+.IP "\fB\-\-certificate=FILE\fP"
+Use the client certificate stored in file (PEM)
+.IP
+.IP "\fB\-\-private\-key=FILE\fP"
+Read the private key from file
+.IP
+.IP "\fB\-\-inrelease\-path\fP"
+Determine the path to the InRelease file of the suite relative to the
+normal position of an InRelease file
+.IP
+
+.SH EXAMPLES
+.
+.PP
+To setup a \fIstretch\fR system:
+.PP
+ debootstrap stretch ./stretch-chroot http://deb.debian.org/debian
+.PP
+ debootstrap stretch ./stretch-chroot file:///LOCAL_MIRROR/debian
+.PP
+Full process to create a complete Debian installation of \fIsid\fR (unstable)
+in a chroot:
+.PP
+ main # debootstrap sid sid-root http://deb.debian.org/debian/
+ [ ... watch it download the whole system ]
+ main # echo "proc sid-root/proc proc defaults 0 0" >> /etc/fstab
+ main # mount proc sid-root/proc -t proc
+ main # echo "sysfs sid-root/sys sysfs defaults 0 0" >> /etc/fstab
+ main # mount sysfs sid-root/sys -t sysfs
+ main # cp /etc/hosts sid-root/etc/hosts
+ main # chroot sid-root /bin/bash
+.SH AUTHOR
+.B debootstrap
+was written by Anthony Towns <ajt@debian.org>.
+This manpage was written by Matt Kraai <kraai@debian.org>.