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