---
name: "buildslave"
section: "1"
platform: "linux"
package: "buildbot-slave"
version: "0.8.12-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/buildslave"
---

# buildslave(1)

a tool for managing buildbot slave instances

## NAME

buildslave - a tool for managing buildbot slave instances

## SYNOPSIS

**buildslave** \[ **global options** \] *command* \[ **command options** \]

**buildslave** create-slave \[ **-q**\|**--quiet** \] \[ **-f**\|**--force** \] \[ **-r**\|**--relocatable** \] \[ **-n**\|**--no-logrotate** \] \[ **-k**\|**--keepalive** *TIME* \] \[ **--usepty** {0\|1} \] \[ **--umask** *UMASK* \] \[ **-s**\|**--log-size** *SIZE* \] \[ **-l**\|**--log-count** *COUNT* \] \[ **--verbose** \] *PATH* *MASTER* *USERNAME* *PASSWORD*

**buildslave** \[ **--verbose** \] { **start**\|**stop**\|**restart** } \[ *PATH* \]

**buildslave** \[ **--verbose** \] { **--help**\|**--version** }

**buildslave** *command* **-h**\|**--help**

## DESCRIPTION

The \`buildslave' command-line tool can be used to start or stop a buildslave or create a new buildslave instance.

## OPTIONS

### Commands

- **create-slave**

  Create and populate a directory for a new buildslave

- **start**

  Start a buildslave

- **stop**

  Stop a buildslave

- **restart**

  Restart a buildslave

### Global options

- **-h**\|**--help**

  Print the list of available commands and global options. All subsequent commands are ignored.

- **--version**

  Print twistd and buildslave version. All subsequent commands are ignored.

- **--verbose**

  Verbose output.

### create-slave command options

- **-f**\|**--force**

  Re-use an existing directory.

- **-h**\|**--help**

  Show help for current command and exit. All subsequent commands are ignored.

- **-k**\|**--keepalive**

  Send keepalive requests to buildmaster every *TIME* seconds. Default value is 600 seconds.

- **-l**\|**--log-count**

  Limit the number of kept old twisted log files to *COUNT*. All files are kept by default.

- **-q**\|**--quiet**

  Do not emit the commands being run.

- **-r**\|**--relocatable**

  Create a relocatable buildbot.tac.

- **-n**\|**--no-logrotate**

  Do not permit buildslave rotate logs by itself.

- **-s**\|**--log-size**

  Set size at which twisted lof file is rotated to *SIZE* bytes. Default value is 1000000 bytes.

- **--umask**

  Set umask for files created by buildslave. Default value is 077 which means only owner can access the files. See [**umask**(2)](/umask/2.md) for more details.

- **--usepty**

  Set wether child processes should be run in a pty (0 means do not run in a pty). Default value is 0.

- *PATH*

  Path to buildslave base directory.

- *MASTER*

  Set the host and port of buildbot master to attach to in form *HOST:PORT*. This should be provided by buildmaster administrator.

- *USERNAME*

  Buildslave name to connect with. This should be provided by buildmaster administrator.

- *PASSWORD*

  Buildslave password to connect with. This should be provided by buildmaster administrator.

## SEE ALSO

[**buildbot**(1)](/buildbot/1.md), [**umask**(2)](/umask/2.md),

The complete documentation is available in texinfo format. To use it, run **info buildbot**.