Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (Debian-3.1)
Apropos / Subsearch:
optional field

DEBOOTSTRAP(8)              Debian GNU/Linux manual             DEBOOTSTRAP(8)

       debootstrap - Bootstrap a basic Debian system

       debootstrap [OPTION]...  SUITE TARGET [MIRROR [SCRIPT]]

       debootstrap  bootstraps  a  basic  Debian  system  of SUITE (eg, woody,
       sarge, sid) into TARGET from MIRROR by running SCRIPT.  MIRROR  can  be
       an  http://  URL  or a file:/// URL. Notice that file:/ URLs are trans-
       lated to file:/// (correct scheme as described  in  RFC1738  for  local
       filenames), and file:// will not work.

       Debootstrap  can be used to install Debian in a system without using an
       installation disk but ca also be used to run a different Debian  flavor
       in  a  chroot  environment.  This  way  you can create a full (minimal)
       Debian installation which can be used for  testing  purposes  (see  the
       EXAMPLES  section).   If  you  are looking for a chroot system to build
       packages please take a look at pbuilder.

       --arch ARCH
              Set the target architecture (use if dpkg isn't installed)

              Download packages, but don't perform installation

              Comma separated list of packages which will be added to download
              and extract lists. Don't forget to resolve the dependencies man-
              ually, otherwise the installation may fail.

              Comma separated list of packages  which  will  be  removed  from
              download  and  extract lists. WARNING: you can and probably will
              exclude essential packages, be careful using this option.

              Name of the bootstrap script variant  to  use.   Currently,  the
              only  variant  supported  is  buildd,  which installs the build-
              essential packages into TARGET.  The default,  with  no  --vari-
              ant=X  argument, is to create a base Debian installation in TAR-

              Produce more info about downloading.

              Print the packages to be installed, and exit

       --unpack-tarball FILE
              Acquire .debs from tarball FILE instead of downloading via http

              Used for internal purposes by boot-floppies

              Used for internal purposes by the debian-installer

       To setup a woody system:

       # debootstrap woody ./woody-chroot http://ftp.cx.debian.org/debian

       # debootstrap woody ./woody-chroot file:///PATH_TO_LOCAL_MIRROR/debian

       Full process to create a complete Debian installation  of  sid  (unsta-

            main # cd / ; mkdir /sid-root
            main # debootstrap sid /sid-root http://ftp.debian.org/debian/
            [ ... watch it download the whole system ]
            main # echo "proc-sid /sid-root/proc proc none 0 0" >> /etc/fstab
            main # mount proc-sid /sid-root/proc -t proc
            main # cp /etc/hosts /sid-root/etc/hosts
            main # chroot /sid-root /bin/bash
            chroot # apt-setup
            [ set-up /etc/apt/sources.list ]
            chroot # vi /etc/apt/sources.list
            [ point the source to unstable ]
            chroot # dselect
            [ you may use aptitude, install mc and vim ... ]
             main # echo "8:23:respawn:/usr/sbin/chroot /sid-root " \
                    "/sbin/getty 38400 tty8"  >> /etc/inittab
            [ define a login tty that will use this system ]
             main # init q
            [ reload init ]

       debootstrap  was  written by Anthony Towns <ajtATdebian.org>.  This man-
       page was written by Matt Kraai <kraaiATdebian.org>.

Debian Project                    2001-04-27                    DEBOOTSTRAP(8)