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 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
pip install buildbot 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 slave 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
- Setuptools (Python package installation utility)
- run easy_install buildbot or pip 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 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 slave are available in the official portage tree and you can install them via emerge (emerge buildbot buildbot-slave)
- 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-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.5 and later)
- run brew install buildbot-slave
It remains to be seen how the various packaging systems will deal with this split.