---
name: "container-create-curl"
section: "1"
platform: "linux"
package: "open-infrastructure-container-tools"
version: "20210101-1"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/container-create-curl"
---

# container-create-curl(1)

Create a Debian based container by downloading a tarball over the network

## 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)](/curl/1.md) 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://get.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/open-infrastructure/container/config**

Container configuration files.

**/usr/share/open-infrastructure/container/scripts**

Container creation scripts.

**/usr/share/doc/compute-tools**

Container documentation.

**/var/lib/machines**

Container directory.

**/var/cache/open-infrastructure/container**

Container cache directory.

## CONTAINER IMAGES

compute-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

[compute-tools(7)](/compute-tools/7.md), [container(1)](/container/1.md).

## HOMEPAGE

More information about compute-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

compute-tools were written by Daniel Baumann \<daniel.baumann@open-infrastructure.net\> and others.