Bruno Cornec > rpmbootstrap-0.11.3 > rpmbootstrap


Annotate this POD

View/Report Bugs
Source   Latest Release: rpmbootstrap-0.12.2


rpmbootstrap - creates a chrooted RPM based distribution a la debootstrap, aka Virtual Environment (VE)


rpmbootstrap creates a chroot environment (Virtual Environment or VE) with a minimal distribution in it, suited for building packages for example. It's very much like debootstrap but for RPM based distribution. It aims at supporting all distributions supported by (RHEL, RH, Fedora, OpeSUSE, SLES, Mandriva, ...)

It is inspired by work done by Steve Kemp for rinse (, and similar to mock, but fully integrated with (which also supports rinse and mock).


rpmbootstrap [-vhmqpdk][-s script][-i iso][-a pkg1[,pkg2,...]] distribution-version-arch [target-dir] [mirror [script]]

rpmbootstrap [--verbose][--help][--man][--quiet][--print-rpms][--download-only] [--keep][--script script][--iso iso][--add pkg1,[pkg2,...]] distribution-version-arch [target-dir] [mirror [script]]



Print a brief help message and exits.


Print a brief help message and exits.


Prints the manual page and exits.


Do not print any output.


Print the packages to be installed, and exit. Note that a target directory must be specified so rpmbootstrap can determine which packages should be installed, and to resolve dependencies. The target directory will be deleted.


Download packages, but don't perform installation.


Keep packages in the cache dir for later reuse. By default remove them.

-s|--script script

Name of the script you want to execute on the related VEs after the installation. It is executed in host environment. You can use the chroot command to execute actions in the VE.

-i|--iso iso_image

Name of the ISO image of the distribution you want to install on the related VE.

-a|--add pkg1[,pkg2,...]

Additional packages to add from the distribution you want to install on the related VE at the end of the chroot build.



Full name of the distribution that needs to be installed in the VE. E.g. fedora-11-x86_64.


This is the target directory under which the VE will be created. Created on the fly if needed. If none is given use the default directory hosting VE for (Cf: vepath parameter in $HOME/.pbrc)


To setup a Fedora 12 distribution with an i386 architecture issue:

rpmbootstrap fedora-12-i386 /tmp/fedora/12/i386


The main Web site of the project is available at Bug reports should be filled using the trac instance of the project at


Cf: for announces and for the development of the pb project.


Uses configuration file (/etc/pb/pb.conf or /usr/local/etc/pb/pb.conf)


The team lead by Bruno Cornec

COPYRIGHT ^ is distributed under the GPL v2.0 license described in the file COPYING included with the distribution.

syntax highlighting: