'\" t
.\"     Title: debspawn-create
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 18 August, 2018
.\"    Manual: debspawn create
.\"    Source: Debspawn
.\"  Language: English
.\"
.TH "DEBSPAWN\-CREATE" "1" "" "Debspawn" "debspawn create"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
debspawn-create \- Create new container images
.SH "SYNOPSIS"
.HP \w'\fBdebspawn\ create\fR\ 'u
\fBdebspawn create\fR [\-h|\-\-help] [\-\-variant] [\-a|\-\-arch] [\-\-suite] [\-\-mirror] [\-\-components] [\-\-base\-suite] [\-\-extra\-suites] [\-\-extra\-sourceslist\-lines] [\-\-allow\-recommends] [\-\-with\-init] {NAME}
.SH "DESCRIPTION"
.PP
Create a new base image for a suite known to
\fBdebootstrap(1)\fR\&. The image will later be used to spawn ephemeral containers in which packages can be built\&.
.SH "EXAMPLES"
.PP
You can easily create images for any suite that has a script in
\fBdebootstrap\fR\&. For example, to create a Debian Unstable image for your current machine architecture, you can use:
.PP
$
\fBdebspawn create\fR
unstable
.PP
A more advanced example, for building on Ubuntu 18\&.10 on the x86 architecture:
.PP
$
\fBdebspawn create\fR
\-\-arch=i386 cosmic
.PP
The suite name is inferred from the container image name given as positional parameter\&. If it can not be inferred, you will need to pass the
\fB\-\-suite\fR
parameter with the primary suite name for this image\&. If a
\fB\-\-base\-suite\fR
is passed and no
\fB\-\-suite\fR
is set, the image name will automatically be assumed to be for an overlay suite, which may not always be the desired result\&.
.SH "OPTIONS"
.PP
NAME
.RS 4
The name of the container image to create (usually the name of the suite)\&.
.RE
.PP
\-h|\-\-help
.RS 4
Print brief help information about available commands\&.
.RE
.PP
\-\-variant
.RS 4
Set the bootstrap script variant (use `none` to select no variant)\&.
.RE
.PP
\-a|\-\-arch
.RS 4
The architecture of the container\&.
.RE
.PP
\-\-suite
.RS 4
Explicitly set a suite name (instead of having it derived from the container name)\&.
.RE
.PP
\-\-mirror
.RS 4
Set a specific mirror to bootstrap from\&.
.RE
.PP
\-\-components
.RS 4
A comma\-separated list of archive components to enable in the newly created image\&.
.RE
.PP
\-\-base\-suite
.RS 4
A full suite that forms the base of the selected partial suite (e\&.g\&. for \-updates and \-backports)\&.
.RE
.PP
\-\-extra\-suites
.RS 4
Space\-separated list of additional suites that should also be added to the sources\&.list file\&.
.RE
.PP
\-\-extra\-sourceslist\-lines
.RS 4
Lines that should be added to the build environments source\&.list verbatim\&. Separate lines by linebreaks\&.
.RE
.PP
\-\-allow\-recommends
.RS 4
Do not disable APT installing "recommends"\-type dependencies by default, and instead use the default behavior for full, normal system installations with "recommends" enabled\&.
.RE
.PP
\-\-with\-init
.RS 4
Include an init system in this image, so it is bootable\&.
.RE
.SH "SEE ALSO"
.PP
debspawn\-build(1), debootstrap(1), systemd\-nspawn(1)\&.
.SH "AUTHOR"
.PP
This manual page was written by Matthias Klumpp
<mak@debian\&.org>\&.
.SH "COPYRIGHT"
.br
Copyright \(co 2018-2022 Matthias Klumpp
.br