First, install the prerequisite libraries. See the [wiki:Prereqs] page for more information.


Before installing, you will need to choose a machine to be the Bcfg2 server. We recommend a Linux-based machine for this purpose, but the server will work on any supported operating system. Note that you may eventually want to run a web server on this machine for reporting and serving up package repositories.

  • ‘’‘From packages:’‘’ The easiest way to install Bcfg2 is from packages for your operating system. You can grab packages (and source packages) for various OSes from the [wiki:Download] page. Install them as you would any other packages. The server package only needs to be installed on your designated Bcfg2 server machine; the clients package needs to be installed on any machine you plan to manage by Bcfg2.
  • ‘’‘From source:’‘’ The Bcfg2 source tarball can also be grabbed from the [wiki:Download] page. After untarring the file, you can build Bcfg2 with {{{python install –prefix=/install/prefix}}} This will install both the client and server on that machine.


Once Bcfg2 is installed, head over to the [wiki:QuickStart] to get it configured and up-and-running.


Using native OS X python

First, make sure you have Xcode installed as you need packagemaker which comes bundled in the Developer tools.

Check out the source from subversion:

svn co

Change to the osx directory and type make. Your new package should be located at bcfg2-‘’‘$VERSION’‘’.pkg (where ‘’‘$VERSION’‘’ is that which is specified in

Using macports

Once macports is installed:

port install bcfg2

Table Of Contents

Previous topic


Next topic

Learning Python

This Page