---
name: "bst"
section: "1"
platform: "linux"
package: "buildstream"
version: "1.6.9-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/bst"
---

# bst(1)

Build and manipulate BuildStream projects...

## NAME

bst - Build and manipulate BuildStream projects...

## SYNOPSIS

**bst** \[OPTIONS\] COMMAND \[ARGS\]...

## DESCRIPTION

Build and manipulate BuildStream projects

Most of the main options override options in the user preferences configuration file.

## OPTIONS

- **--version**

  - **-c,** --config FILE

  Configuration file to use

- **-C,** --directory DIRECTORY

  Project directory (default: current directory)

- **--on-error** \[continue\|quit\|terminate\]

  What to do when an error is encountered

- **--fetchers** INTEGER

  Maximum simultaneous download tasks

- **--builders** INTEGER

  Maximum simultaneous build tasks

- **--pushers** INTEGER

  Maximum simultaneous upload tasks

- **--max-jobs** INTEGER

  Number of parallel jobs allowed for a given build task

- **--network-retries** INTEGER

  Maximum retries for network tasks

- **--no-interactive**

  Force non interactive mode, otherwise this is automatically decided

- **--verbose** / --no-verbose

  Be extra verbose

- **--debug** / --no-debug

  Print debugging output

- **--error-lines** INTEGER

  Maximum number of lines to show from a task log

- **--message-lines** INTEGER

  Maximum number of lines to show in a detailed message

- **--log-file** FILENAME

  A file to store the main log (allows storing the main log while in interactive mode)

- **--colors** / --no-colors

  Force enable/disable ANSI color codes in output

- **--strict** / --no-strict

  Elements must be rebuilt when their dependencies have changed

- **-o,** --option OPTION VALUE

  Specify a project option

- **--default-mirror** TEXT

  The mirror to fetch from first, before attempting other mirrors

## COMMANDS

**help**\
   Print usage information\
   See **[bst-help(1)](/bst-help/1.md)** for full documentation on the **help** command.

**init**\
   Initialize a new BuildStream project\
   See **[bst-init(1)](/bst-init/1.md)** for full documentation on the **init** command.

**build**\
   Build elements in a pipeline\
   See **[bst-build(1)](/bst-build/1.md)** for full documentation on the **build** command.

**fetch**\
   Fetch sources in a pipeline\
   See **[bst-fetch(1)](/bst-fetch/1.md)** for full documentation on the **fetch** command.

**track**\
   Track new source references\
   See **[bst-track(1)](/bst-track/1.md)** for full documentation on the **track** command.

**pull**\
   Pull a built artifact\
   See **[bst-pull(1)](/bst-pull/1.md)** for full documentation on the **pull** command.

**push**\
   Push a built artifact\
   See **[bst-push(1)](/bst-push/1.md)** for full documentation on the **push** command.

**show**\
   Show elements in the pipeline\
   See **[bst-show(1)](/bst-show/1.md)** for full documentation on the **show** command.

**shell**\
   Shell into an element's sandbox environment\
   See **[bst-shell(1)](/bst-shell/1.md)** for full documentation on the **shell** command.

**checkout**\
   Checkout a built artifact\
   See **[bst-checkout(1)](/bst-checkout/1.md)** for full documentation on the **checkout** command.

**workspace**\
   Manipulate developer workspaces\
   See **[bst-workspace(1)](/bst-workspace/1.md)** for full documentation on the **workspace** command.

**source-bundle**\
   Produce a build bundle to be manually executed\
   See **[bst-source-bundle(1)](/bst-source-bundle/1.md)** for full documentation on the **source-bundle** command.