---
name: "debspawn-run"
section: "1"
platform: "linux"
package: "debspawn"
version: "0.6.4-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/debspawn-run"
---

# debspawn-run(1)

Run arbitrary commands in debspawn container session

## NAME

debspawn-run - Run arbitrary commands in debspawn container session

## SYNOPSIS

**debspawn run** \[-h\|--help\] \[--variant\] \[-a\|--arch\] \[--suite\] \[--artifacts-out\] \[--build-dir\] \[--bind-build-dir\] \[--cachekey\] \[--init-command\] \[-x\|--external-command\] \[--header\] \[--allow\] \[--boot\] {NAME} {COMMAND}

## DESCRIPTION

This subcommand allows you to run arbitrary commands in an ephemeral **debspawn** container, using the same environment that is normally used for building packages.

**debspawn run** is explicitly designed to be used by other automation tools for custom applications, and usually you will want to use **debspawn build** instead to build Debian packages.

## OPTIONS

NAME

The name of the container image (usually a distribution suite name).

COMMAND

The command to run.

\-h\|--help

Print brief help information about available commands.

- \--variant

  Set the variant of the selected image, that was used for bootstrapping.

\-a\|--arch

The architecture of the base image that should be selected.

- \--suite

  Explicitly set a suite name (instead of having it derived from the container name).

- \--artifacts-out

  Directory on the host where artifacts can be stored. Mounted to /srv/artifacts in the guest.

- \--build-dir

  Select a host directory that gets copied to /srv/build.

- \--bind-build-dir

  Bindmount build directory instead of copying it. Mounts read-only by default, but can mount as writable as well if 'rw' is passed as value.

- \--cachekey

  If set, use the specified cache-ID to store an initialized container image for faster initialization times. This may mean that the command passed in \`--init-command\` is skipped if the cache already existed.

- \--init-command

  The command or command script used to set up the container.

\-x\|--external-command

If set, the command script(s) will be copied from the host to the container and then executed.

- \--header

  Name of the task that is run, will be printed as header.

- \--allow

  List one or more additional permissions to grant the container. Takes a comma-separated list of capability names.

- \--boot

  Boot container image (requires the image to contain an init system).

## SEE ALSO

[debspawn-build(1)](/debspawn-build/1.md).

## AUTHOR

This manual page was written by Matthias Klumpp \<mak@debian.org\>.

## COPYRIGHT

Copyright © 2018-2022 Matthias Klumpp\