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 http://docs.buildbot.net/latest/ 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 setup.py install as per the documentation.
- Read the documentation about configuring your new buildbot.
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 SlackBuilds.org
- packages from OpenCSW are available for buildmaster and buildslave.
- Marcus Rueckert has made SUSE RPMs available at http://download.opensuse.org/repositories/devel:/tools:/building/ . 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.