= Welcome to Buildbot =

The !BuildBot is a system to automate the compile/test cycle required by most software projects to validate code changes. By automatically rebuilding and testing the tree each time something has changed, build problems are pinpointed quickly, before other developers are inconvenienced by the failure. The guilty developer can be identified and harassed without human intervention. By running the builds on a variety of platforms, developers who do not have the facilities to test their changes everywhere before checkin will at least know shortly afterwards whether they have broken the build or not. Warning counts, lint checks, image size, compile time, and other build parameters can be tracked over time, are more visible, and are therefore easier to improve.

The overall goal is to reduce tree breakage and provide a platform to run tests or code-quality checks that are too annoying or pedantic for any human to waste their time with. Developers get immediate (and potentially public) feedback about their changes, encouraging them to be more careful about testing before checkin.

Current contents:

 * The current release is buildbot-0.7.5 . You can download the source from the [http://sourceforge.net/project/showfiles.php?group_id=73177 sf.net download page]. The release is signed with [http://www.lothar.com/warner-gpg.html my GPG public key].
 * The latest code is available from CVS for [http://buildbot.cvs.sourceforge.net/buildbot/buildbot/ browsing] or [http://sourceforge.net/cvs/?group_id=73177 read-only checkout]. There are also [BuildbotSourcesFromArch Arch and Darcs repositories] which track the main CVS tree and provide lower-latency access than anonymous CVS. You might want to look at the CVS version of the [http://buildbot.sf.net/manual-CVS.html user's manual] to get an idea of what sorts of features are coming up in the next release.
 * The [http://buildbot.sf.net/README README] file contains an overview, while the [UserManual User's Manual] contains complete documentation. The [http://buildbot.sf.net/API-0.7.5/index.html API Reference] may be useful when writing the configuration file: the various Steps and Schedulers are documented there.
 * Recent changes are summarized in the [http://buildbot.sf.net/NEWS NEWS] file, while the complete details are in the [http://buildbot.sf.net/ChangeLog ChangeLog].
 * The [http://buildbot.sf.net/PyCon-2003/buildbot.html paper] paper delivered at PyCon-2003, along with the [http://buildbot.sf.net/PyCon-2003/slides/slide-01.html slides].
 * The [https://sourceforge.net/projects/buildbot/ SourceForge Project Page]
 * Please join the [http://lists.sourceforge.net/lists/listinfo/buildbot-devel buildbot-devel mailing list] to be notified about new releases, discuss how to configure and use the buildbot, and to hear about new development. This is both a user and a developer mailing list.
 * You can also join the [http://lists.sourceforge.net/lists/listinfo/buildbot-commits buildbot-commits mailing list] to be notified about changes in CVS.
 * There is a brief RoadMap listing goals for the next few releases.

== Download ==

    *  From Source: download the latest version from the SourceForge [https://sourceforge.net/project/showfiles.php?group_id=73177 download page], run setup.py install as per the README, and read the UserManual about configuring your new buildbot.
    * Debian Users: install the 'buildbot' [http://packages.debian.org/buildbot package] from the 'unstable' or 'testing' distribution.
    * Ubuntu Users: install the 'buildbot' [http://packages.ubuntu.com/buildbot package] from the Dapper 'universe' section (version 0.7.2 in dapper, 0.7.4 in edgy). (thanks to Matthias Klose for making both of these debian versions happen!). For newer versions, look for backports or install from source.
    * SUSE Users: 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.
    * Darwin Users: run port install buildbot (thanks to Olivier Bonnet for [http://bugzilla.opendarwin.org/show_bug.cgi?id=8888 making this happen]!)

== Success Stories ==

Buildbots are installed in at least 100 sites all over the world. Users have submitted pointers to the SucessStories page, so you can get a feel for how Buildbot is being used.
Install a buildbot today and add your name!


The original TracStartingPage was moved away.