DOKK / manpages / debian 12 / debspawn / debspawn-run.1.en
DEBSPAWN-RUN(1) debspawn run DEBSPAWN-RUN(1)

debspawn-run - Run arbitrary commands in debspawn container session

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}

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.


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


The command to run.


Print brief help information about available commands.


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


The architecture of the base image that should be selected.


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


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


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


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.


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.


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


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


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


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


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


This manual page was written by Matthias Klumpp <>.

Copyright © 2018-2022 Matthias Klumpp