Provided by: sbuild_0.67.0-2ubuntu7_all bug


       sbuild-createchroot - create sbuild chroot


       sbuild-createchroot   [-h|--help  |  -V|--version]  [--verbose]  [--arch=arch]  [--chroot-
       suffix=suffix] [--foreign] [--resolve-deps |  --no-resolve-deps]  [--keep-debootstrap-dir]
       [--debootstrap=debootstrap]                     [--include=package1[,package2,[packagen]]]
       [--components=component1[,component2,[componentn]]]               [--keyring=keyring-file]
       [--setup-only]  [--make-sbuild-tarball=file]  [--keep-sbuild-chroot-dir]   SUITE   TARGET-



       sbuild-createchroot  runs debootstrap(1) to create a chroot suitable for building packages
       with sbuild.  Note that  while  debootstrap  may  be  used  directly,  sbuild-createchroot
       performs additional setup tasks such as adding additional packages and configuring various
       files in the chroot.  Invoking sbuild-createchroot is functionally equivalent  to  running
       debootstrap --variant=buildd      --include=fakeroot,build-essential,     then     editing
       /etc/apt/sources.list and /etc/hosts by hand.

       The newly-created chroot is set up to work with schroot(1) by creating a chroot definition
       file   under   /etc/schroot/chroot.d.    This  should  be  edited  to  finish  the  chroot
       configuration after sbuild-createchroot has completed.

       buildd-create-chroot, like sbuild-createchroot, runs debootstrap(1) to create a chroot for
       package  building.   However,  this  creates  a  chroot specifically for buildd(1) with an
       additional mandatory option to specify a user who will be granted sudo access  inside  the
       chroot.     This    script   mainly   differs   in   its   additional   customisation   of
       /etc/apt/sources.list to use and  It  also
       removes  some  packages  from  the  newly-created  chroot.   Unless  you are setting up an
       official Debian build daemon, sbuild-createchroot  should  be  used  instead.   The  extra
       functionality will be merged into sbuild-createchroot in the future.


       -h, --help
              Display this manual.

       -V, --version
              Print version information.

   General options
       -v, --verbose
              Print all messages.

   Debootstrap options
       Note  that  debootstrap(1) is the canonical reference for the meaning of the options; they
       are passed directly to debootstrap.

              Set the target architecture.  This may be used if dpkg is  not  already  installed.
              See also --foreign, below.

              Add a custom suffix to the chroot name. Defaults to '-sbuild'.

              Only  perform  the  initial unpack phase of bootstrapping.  This is required if the
              target and host architectures do not match.  Note that debootstrap requires running
              by  hand  to  complete  installation;  run the debootstrap /debootstrap/debootstrap
              installed in TARGET-DIRECTORY to complete the installation.

              Automatically resolve missing dependencies.  This is the default.

              Do not automatically resolve missing dependencies.

              Don't delete the /debootstrap directory in TARGET-DIRECTORY  after  completing  the

              Define a custom debootstrap variant. Defaults to 'debootstrap'.

              Comma  separated  list  of  packages which will be added to the list of packages to
              download and extract.

              Comma separated list of packages which will be removed from the list of packages to
              download  and  extract.  Note  that this can remove essential packages, so use with
              extreme care.

              Comma separated list of archive components to use (e.g.  ‘main’,  ‘contrib’,  ‘non-
              free’).  Defaults to ‘main’.

              Download  signatures  for  retrieved  Release files and check them against keyring-
              file.  By default /etc/apt/trusted.gpg is used.  Set to an empty string to  disable
              signature checking.

       SUITE  The  distribution  to bootstrap (e.g. ‘sarge’, ‘etch’, ‘lenny’, ‘sid’).  A complete
              list may be found in /usr/share/debootstrap/scripts.

              The directory to create the chroot in.  The directory will be created  if  it  does
              not already exist.

              An http://, file:///, or ssh:/// URI pointing to a suitable archive mirror.

       SCRIPT debootstrap script to run.  Not typically required.

   sbuild-createchroot behaviour
              Don't run debootstrap.  Only perform the setup tasks on an already existing chroot.
              This is useful for converting an existing chroot for  use  with  sbuild  which  has
              already been created using a tool such as debootstrap.

              Create  a  bootstrapped  file  type chroot ready for use with sbuild and save it as
              file. The compression format  used  for  the  tarball  is  dependent  on  the  file
              extension used in file. See the TARBALL FILE section for more details.

              Don't  delete  the directory used for creating a file type chroot. This option does
              nothing if not creating a file type chroot.


       When creating an sbuild tarball file, the compression format used to generate the  tarball
       depends  on  the  entension used in file. Here is a listing of the extensions that will be
       detected and what format the tarball will be generated as.

       *.tar  Generates an uncompressed tarball.

              Generates a compressed tarball using gzip.

              Generates a compressed tarball using bzip2.

              Generates a compressed tarball using lzip.

              Generates a compressed tarball using xz.

       If no extension is specified, sbuild-createchroot will  rename  file  to  file.tar.gz  and
       generate file.tar.gz as a compressed tarball using gzip.


       To  create  a  bootstrapped  file type sid (unstable) chroot ready for use with sbuild and
       saved in /var/cache/sbuild/sbuild.tar.gz using the Debian http mirror
       redirector service and using a temporary directory as the target:

       % sudo sbuild-createchroot \
           --make-sbuild-tarball=/srv/chroot/unstable-amd64.tar.gz \
           sid `mktemp -d` \

       To   create  a  plain  type  sid  (unstable)  chroot  in  /srv/chroot/unstable  using  the Debian http mirror redirector service:

       % sudo sbuild-createchroot sid /srv/chroot/unstable-amd64 \


       sbuild-createchroot  was  previously  known  as  buildd.chroot.   buildd.chroot  performed
       exactly the same tasks, but additionally created a number of directories in the chroot for
       use by sbuild.  This is now done by schroot(1).


       Roger Leigh.
       Francesco P. Lovergine.
       Andres Mejia.


       Copyright © 2004 Francesco P. Lovergine <>.
       Copyright © 2007-2008 Roger Leigh <>.
       Copyright © 2010 Andres Mejia <>.


       debootstrap(8), schroot(1), sbuild(1), sbuild-setup(7).