Provided by: sbuild_0.62.6-1ubuntu2_all bug


       sbuild-createchroot - create sbuild chroot


       sbuild-createchroot  [-h|--help  |  -V|--version]  [--verbose]  [--arch=arch]  [--foreign]
       [--resolve-deps          |           --no-resolve-deps]           [--keep-debootstrap-dir]
       [--include=package1[,package2,[packagen]]]      [--exclude=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.

              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

              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  plain  type  sid  (unstable)  chroot  in  /srv/chroot/unstable  using   the Debian mirror:

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

       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  mirror  and
       using a temporary directory as the target:

       % sudo sbuild-createchroot \
           --make-sbuild-tarball=/var/cache/sbuild/sbuild.tar.gz \
           sid `mktemp -d` \


       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).