CONTAINER-CREATE-C(1)

NAME
container-create-curl - Create a Debian based container by downloading a tarball over the network

SYNOPSIS

container create -s curl [OPTIONS]

DESCRIPTION

The curl container creation script uses curl(1) to download a tarball over the network to create a Debian based container.

Depending on the tarball this script otherwise creates a pure Debian system with three modificiations:

    • hostname is set (container name) in /etc/hostname

    • systemd machine-id is generated in /etc/machine-id

    • root password is set (user specified or 16 random characters)

OPTIONS

The following script options are available:

-n, --name=NAME
    Specify container name.

-a, --architecture=ARCHITECTURE
    Specify container architecture.

"--clean*
    Remove downloaded tarball after successfull container creation.

-p, --root-password=PASSWORD
    Specify the root password, defaults to a random 16 character password.

--server=SERVER
    Specify the image server to download from, defaults to https://files.open-infrastructure.net/system/container/debian.

--setup=SETUP

--system=SYSTEM

EXAMPLES

Create a Debian 9 (stretch) based container with same architecture as the host system:
    sudo container create -s curl -n stretch.example.net

Create a Debian 9 (stretch) based container with different architecture as the host system:
    sudo container create -s curl -n stretch-i386.example.net — --system debian-stretch-current_i386.system.tar.xz

FILES

The following files are used:

/etc/container-tools/config
    Container configuration files.

/usr/share/container-tools/scripts
    Container creation scripts.

/usr/share/doc/container-tools
    Container documentation.

/var/lib/machines
    Container directory.

/var/cache/container-tools
    Container cache directory.

CONTAINER IMAGES

container-tools will download tarballs from a server expecting that the images are tarballs with either gzip, lzip, xz, or no compression. See container-images.sh as an example on how to create your own container images.

SEE ALSO

container-tools(7), container(1).

HOMEPAGE

More information about container-tools and the Open Infrastructure project can be found on the homepage at https://open-infrastructure.net.

CONTACT

Bug reports, feature requests, help, patches, support and everything else are welcome on the Open Infrastructure Software Mailing List <software@lists.open-infrastructure.net>.

Debian specific bugs can also be reported in the Debian Bug Tracking System at https://bugs.debian.org.

AUTHORS

container-tools was written by Daniel Baumann <daniel.baumann@open-infrastructure.net>.