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 slaves or masters on Windows, see RunningBuildbotOnWindows

What are you Installing?

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

Master

The Easy Way

easy_install buildbot
buildbot create-master /tmp/experimental_buildmaster
# create /tmp/experimental_buildmaster/master.cfg
# see http://buildbot.net/buildbot/docs/latest/
buildbot start /tmp/experimental_buildmaster

Building Buildbot from Source

• Download the latest version from PyPI, ​master and ​slave pages. New releases are no longer uploaded to SourceForge nor Google Code.
• In master, run setup.py install as per the ​README.
  • Read the documentation about configuring your new buildbot.

Installing from Binary Packages

Setuptools (Python package installation utility)

run easy_install buildbot or pip install buildbot

DarwinPorts

run port install buildbot (thanks to Olivier Bonnet for ​making this happen!)

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.

Fedora

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.

FreeBSD

Ports: portmaster ​devel/buildbot or ​devel/buildbot-slave

Packages: pkg add buildbot or pkg add buildbot-slave

Gentoo

The buildbot ​master and ​slave are available in the official portage tree and you can install them via emerge ( "emerge buildbot buildbot-slave" )

MacPorts

run port install buildbot

Slackware

Markus Reichelt maintains buildbot-slave at ​SlackBuilds.org

Solaris

packages from OpenCSW are available for ​buildmaster and ​buildslave.

SUSE

Marcus Rueckert has made SUSE RPMs available at ​http://software.opensuse.org/download/devel:/tools:/building/ . There is also ​user documentation available.

Ubuntu

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.

Slave

Similar to the above, but

easy_install buildbot-slave
buildslave create-slave /tmp/experimental_buildslave .. .. ..
buildslave start /tmp/experimental_buildslave

Slave in Virtualenv

mkdir buildslave_env
cd buildslave_env
virtualenv .
source bin/activate
pip install buildbot-slave
buildslave create-slave /tmp/experimental_buildslave .. .. ..
buildslave start /tmp/experimental_buildslave

Homebrew (Mac OS X 10.4 and later)

run "brew install buildbot-slave"

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