unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

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



NAME
       debootstrap - Bootstrap a basic Debian system

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

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

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

       --download-only
              Download packages, but don't perform installation

       --include=alpha,beta
              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.

       --exclude=alpha,beta
              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.

       --variant=buildd
              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-
              GET.

       --verbose
              Produce more info about downloading.

       --print-debs
              Print the packages to be installed, and exit

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

       --boot-floppies
              Used for internal purposes by boot-floppies

       --debian-installer
              Used for internal purposes by the debian-installer

EXAMPLE
       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-
       ble):

            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 ]

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