Please read the [http://buildbot.net/buildbot/docs/latest/release-notes.html 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: [http://pypi.python.org/pypi/buildbot buildbot] (the master) and [http://pypi.python.org/pypi/buildbot-slave buildbot-slave] (the slave).  You can install either or both on any given machine.

= 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 the Google Code [http://code.google.com/p/buildbot/downloads/list downloads page].  New releases are no longer uploaded to !SourceForge.
 * In {{{master}}}, run {{{setup.py install}}} as per the [http://github.com/buildbot/buildbot/raw/master/master/README README].
  * Read the [http://buildbot.net/buildbot/docs/latest/ documentation] about configuring your new buildbot.

== Installing from Binary Packages ==
 Setuptools (Python package installation utility)::
  run {{{easy_install buildbot}}}
 Debian Users::
  install the [http://packages.debian.org/buildbot buildbot] or [http://packages.debian.org/buildbot-slave buildbot-slave] package. The current Debian stable release ("squeeze") has 0.7.12, but there is a newer version in the 'unstable' or 'testing' distribution, currently 0.8.3p1. There is v0.7.12 available in the oldstable branch, aka "Lenny".
 Ubuntu::
  install the 'buildbot' [http://packages.ubuntu.com/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.
 SUSE::
  Marcus Rueckert has made SUSE RPMs available at http://software.opensuse.org/download/devel:/tools:/building/ . There is also [http://en.opensuse.org/Build_Service/User user documentation] available.
 Fedora::
  install the 'buildbot' [http://koji.fedoraproject.org/koji/packageinfo?packageID=1421 package] via yum ( "yum install buildbot" )
 !DarwinPorts::
  run port install buildbot (thanks to Olivier Bonnet for [http://bugzilla.opendarwin.org/show_bug.cgi?id=8888 making this happen]!)
 Fink (Mac OS X 10.4 and later)::
  run "fink install buildbot-py25" or "fink install buildbot-py26", depending on your preferred Python version.
 Solaris::
  you have to install buildbot from source yourself, but Matthew Flanagan has written a [http://wadofstuff.blogspot.com/2007/01/smf-manifest-for-buildbot.html Solaris 10 SMF manifest] which will help automatically launch the buildmaster or buildslave as a Solaris service.
 Other RPM-based distributions::
  see [wiki:SourceRPMS 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
}}}

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