'\" t
.\"     Title: container-create-debootstrap
.\"    Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 20190304
.\"    Manual: Open Infrastructure
.\"    Source: compute-tools
.\"  Language: English
.\"
.TH "CONTAINER\-CREATE\-D" "1" "20190304" "compute\-tools" "Open Infrastructure"
.\" -----------------------------------------------------------------
.\" * 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"
container-create-debootstrap \- Create a basic Debian based container with debootstrap or mmdebstrap
.SH "SYNOPSIS"
.sp
\fBcontainer create \-s debootstrap\fR [\fIOPTIONS\fR] \fBcnt cr \-s debootstrap\fR [\fIOPTIONS\fR]
.sp
\fBcontainer create \-s mmdebstrap\fR [\fIOPTIONS\fR] \fBcnt cr \-s mmdebstrap\fR [\fIOPTIONS\fR]
.SH "DESCRIPTION"
.sp
The debootstrap container creation script uses debootstrap(8) or mmdebstrap(1) to create a Debian based container\&.
.sp
This script creates a pure Debian system with three modificiations:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
apt cache of packages downloaded during debootstrap is cleaned
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
hostname is set (container name) in /etc/hostname
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
root password is set (user specified or 16 random characters)
.RE
.SH "OPTIONS"
.sp
The following script options are available:
.PP
\fB\-n, \-\-name=\fR\fB\fINAME\fR\fR
.RS 4
Specify container name\&.
.RE
.PP
\fB\-a, \-\-architecture=\fR\fB\fIARCHITECTURE\fR\fR
.RS 4
Specify the Debian architecture, defaults to the host systems architecture\&.
.RE
.PP
\fB\-d, \-\-distribution=\fR\fB\fIDISTRIBUTION\fR\fR
.RS 4
Specify the Debian distribution, defaults to stretch\&.
.RE
.PP
\fB\-m, \-\-mirror=\fR\fB\fIMIRROR\fR\fR
.RS 4
Specify the Debian mirror, defaults to
https://deb\&.debian\&.org/debian\&.
.RE
.PP
\fB\-p, \-\-root\-password=\fR\fB\fIPASSWORD\fR\fR
.RS 4
Specify the root password, defaults to a random 16 character password\&.
.RE
.SH "EXAMPLES"
.PP
\fBCreate a Debian 9 (stretch) based container with same architecture as the host system using debootstrap:\fR
.RS 4
sudo container create \-s debootstrap \-n stretch\&.example\&.net
.RE
.PP
\fBCreate a Debian 9 (stretch) based container with different architecture as the host system using mmdebstrap:\fR
.RS 4
sudo container create \-s mmdebstrap \-n stretch\-i386\&.example\&.net \(em \-a i386
.RE
.SH "SEE ALSO"
.sp
compute\-tools(7), container(1)\&.
.SH "HOMEPAGE"
.sp
More information about compute\-tools and the Open Infrastructure project can be found on the homepage at https://open\-infrastructure\&.net\&.
.SH "CONTACT"
.sp
Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List <software@lists\&.open\-infrastructure\&.net>\&.
.sp
Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs\&.debian\&.org\&.
.SH "AUTHORS"
.sp
compute\-tools were written by Daniel Baumann <daniel\&.baumann@open\-infrastructure\&.net> and others\&.