Please read the release notes if you are upgrading from a previous release! It contains important information about compatibility and changes you must make to your configuration file

The following instructions are specific to installation on version of Unix. For instructions on installing Buildbot workers or masters on Windows, see RunningBuildbotOnWindows

What are you Installing?

Buildbot comes in two pieces: buildbot (the master) and buildbot-worker (the worker). You can install either or both on any given machine. You can also check downloaded files against Buildbot keyring.


The Easy Way

virtualenv sandbox
. sandbox/bin/activate
pip install 'buildbot[bundle]'
buildbot create-master /tmp/experimental_buildmaster
# create /tmp/experimental_buildmaster/master.cfg
# see
buildbot start /tmp/experimental_buildmaster

Building Buildbot from Source

  • Download the latest version from PyPI, master and worker pages. New releases are no longer uploaded to SourceForge nor Google Code.
  • In master, run install as per the documentation.

Installing from Binary Packages

Those instructions are mostly for installing the 0.8.x version of buildbot. For buildbot nine it is at the moment recomended to install via pip and virtualenv.

Debian Users
install the buildbot and/or buildbot-slave package. The current Debian stable release ("wheezy") has 0.8.6p1, but there is a newer version in the 'unstable' or 'testing' distribution, currently 0.8.9.
install the 'buildbot' package via yum (yum install buildbot)
Fink (Mac OS X 10.4 and later)
run fink install buildbot-py25 or fink install buildbot-py26, depending on your preferred Python version.
Ports: portmaster devel/buildbot or devel/buildbot-slave

Packages: pkg install buildbot or pkg install buildbot-slave

The buildbot master and worker are available in the official portage tree and you can install them via emerge (emerge buildbot buildbot-worker)
MacPorts (Mac OS X 10.4 and later)
run sudo port install buildbot or sudo port install buildbot-slave
Markus Reichelt maintains buildbot-slave at
packages from OpenCSW are available for buildmaster and buildslave.
Marcus Rueckert has made SUSE RPMs available at . There is also user documentation available.
install the 'buildbot' package from the 'universe' section (version 0.7.2 in dapper, 0.7.6 in hardy, 0.7.9 in intrepid and jaunty, 0.7.11p3 in karmic and lucid). Thanks to Matthias Klose for making both of these Debian versions happen! For newer versions, look for backports or install from source.
Other RPM-based distributions
see Building RPMs to produce RPMs for your Linux distribution, including RHEL and CentOS.


Similar to the above, but

easy_install buildbot-worker
buildbot-worker create-worker /tmp/experimental_worker .. .. ..
buildbot-worker start /tmp/experimental_worker

Worker in Virtualenv

mkdir worker_env
cd worker_env
virtualenv .
source bin/activate
pip install buildbot-worker
buildbot-worker create-worker /tmp/experimental_worker .. .. ..
buildbot-worker start /tmp/experimental_worker
Homebrew (Mac OS X 10.5 and later)
run brew install buildbot-slave

It remains to be seen how the various packaging systems will deal with this split.

Last modified 4 years ago Last modified on Jan 22, 2017, 10:43:32 PM