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

# bst-track(1)

Track new source references

## NAME

bst-track - Track new source references

## SYNOPSIS

**bst track** \[OPTIONS\] \[ELEMENTS\]...

## DESCRIPTION

Consults the specified tracking branches for new versions available to build and updates the project with any newly available references.

By default this will track just the specified element, but you can also update a whole tree of dependencies in one go.

Specify \`--deps\` to control which sources to track:

\
     none:  No dependencies, just the specified elements\
     all:   All dependencies of all specified elements

## OPTIONS

- **--except** PATH

  Except certain dependencies from tracking

- **-d,** --deps \[none\|all\]

  The dependencies to track (default: none)

- **-J,** --cross-junctions

  Allow crossing junction boundaries