Buildbot - manual page for Buildbot version: 0.7.11p3
buildbot [global options] <command> [command options]
The ‘buildbot’ command-line tool can be used to start or stop a
buildmaster or buildbot, and to interact with a running buildmaster.
Some of its subcommands are intended for buildmaster admins, while some
are for developers who are editing the code that the buildbot is
These are the global buildbot options:
--help Display this help and exit.
Create and populate a directory for a new buildmaster:
buildbot create-master [--quiet] [--force] [--config=FILE]
[--log-size=SIZE] [--log-count=COUNT] BASEDIR
Upgrade an existing buildmaster directory for the current
version. When this command is finished, the buildmaster
directory should look much like a brand-new one created by the
buildbot upgrade-master [--quiet] [--replace] BASEDIR
Create and populate a directory for a new buildslave
buildbot create-slave BASEDIR MASTERHOST:PORT
start Start a buildmaster or buildslave
buildbot start [--quiet] BASEDIR
stop Stop a buildmaster or buildslave
buildbot stop [--quiet] BASEDIR
Restart a buildmaster or buildslave
buildbot restart [--quiet] BASEDIR
SIGHUP a buildmaster to make it re-read the config file. The
sighup command is an alias for this command.
buildbot reconfig [--quiet] BASEDIR
test the validity of a master.cfg config file
buildbot checkconfig [CONFIG_FILE]
buildmaster-side ’try’ support function, not for users
Buildmaster debug commands
These commands are also used by buildmaster administrators but not an
Send a change to the buildmaster. The buildmaster must have been
configured already to accept changes.
buildbot sendchange --master=HOST:PORT --username=USERNAME
[--revision=STRING | --revision-number=NUMBER |
--revision-file=FILENAME ] [--comments=LOG_MESSAGE ]
Launch a small debug panel GUI
buildbot debuclient [--master=HOST:PORT] [--passwd=PASSWORD]
Emit current builder status to stdout
buildbot statuslog [--master=HOST:PORT]
Display a small window showing current builder status
buildbot statusgui [--master=HOST:PORT]
try Run a build with your local changes. This command requires in-
advance configuration of the buildmaster to accept such build
requests. Please see the documentation for details about this
The full documentation for Buildbot is maintained as a Texinfo manual.
If the info and Buildbot programs are properly installed at your site,
should give you access to the complete manual.
This manual page was written by Iustin Pop <firstname.lastname@example.org>, for the
Debian project (and may be used by others).