Provided by: sbuild_0.62.5-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]]]
       [--components=component1[,component2,[componentn]]] [--keyring=keyring-
       file]            [--setup-only]            [--make-sbuild-tarball=file]
       [--keep-sbuild-chroot-dir]   SUITE  TARGET-DIRECTORY  DEBIAN-MIRROR-URI



       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

       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   security-   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

              Do not automatically resolve missing dependencies.

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

              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

              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


       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

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