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.
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
- 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 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.
- Marcus Rueckert has made SUSE RPMs available at http://software.opensuse.org/download/devel:/tools:/building/ . There is also user documentation available.
- Markus Reichelt maintains buildbot-slave at SlackBuilds.org
- install the 'buildbot' package via yum ( "yum install buildbot" )
- The buildbot master and slave are available in the official portage tree and you can install them via emerge ( "emerge buildbot buildbot-slave" )
- run port install buildbot (thanks to Olivier Bonnet for making this happen!)
- run port 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.
- packages from OpenCSW are available for buildmaster and buildslave.
- 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-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.