NAME

       debspawn - Build in nspawn containers

SYNOPSIS

       debspawn [-h|--help] [-c|--config] [--verbose] [--no-unicode] [--version] [--owner] [COMMAND]

DESCRIPTION

       This manual page documents the debspawn command.

       debspawn is a tool to build Debian packages in an isolated environment, using nspawn containers. By using
       containers, Debspawn can isolate builds from the host system much better than a regular chroot could. It
       also allows for more advanced features to manage builds, for example setting resource limits for
       individual builds.

       Please keep in mind that Debspawn is not a security feature! While it provides a lot of isolation from
       the host system, you should not run arbitrary untrusted code with it. The usual warnings for all
       technology based on Linux containers apply here. See systemd-nspawn(1) for more information on the
       container solution Debspawn uses.

       Debspawn also allows one to run arbitrary custom commands in its environment. This is useful to execute a
       variety of non-package build and QA actions that make sense to be run in the same environment in which
       packages are usually built.

       For more information about the Debspawn project, you can visit its project page[1].

SUBCOMMANDS

       debspawn actions are invoked via subcommands. Refer to their individual manual pages for further details.

       create
           Create a new container base image for a specific suite, architecture and variant. A custom mirror
           location can also be provided. For details, see debspawn-create(1).

       list
           List information about all container image that Debspawn knows on the current host. For details, see
           debspawn-list(1).

       delete
           Delete a container base image and all data associated with it. For details, see debspawn-delete(1).

       update
           Update a container base image, ensuring all packages are up to date and the image is set up properly
           for use with debspawn. For details, see debspawn-update(1).

       build
           Build a Debian package in an isolated environment. For details, see debspawn-build(1).

       login
           Get an interactive shell session in a container. For details, see debspawn-login(1).

       run
           Run arbitrary commands in debspawn container session. This is primarily useful for using debspawn to
           isolate non-package build processes. For details, see debspawn-run(1).

FLAGS

       -h|--help
           Print brief help information about available commands.

       -c|--config
           Path to the global config file.

       --verbose
           Enable debug messages.

       --no-unicode
           Disable unicode support.

       --version
           Display the version of debspawn itself.

       --owner
           Set the user name/uid and group/gid separated by a colon whose behalf we are acting.

SEE ALSO

       dpkg-buildpackage(1), systemd-nspawn(1), sbuild(1).

AUTHOR

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

COPYRIGHT

       Copyright © 2018-2020 Matthias Klumpp

NOTES

        1. project page
           https://github.com/lkorigin/debspawn

Debspawn                                                                                             DEBSPAWN(1)