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

# bst-checkout(1)

Checkout a built artifact

## NAME

bst-checkout - Checkout a built artifact

## SYNOPSIS

**bst checkout** \[OPTIONS\] ELEMENT LOCATION

## DESCRIPTION

Checkout a built artifact to the specified location

## OPTIONS

- **-f,** --force

  Allow files to be overwritten

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

  The dependencies to checkout (default: run)

- **--integrate** / --no-integrate

  Whether to run integration commands

- **--hardlinks**

  Checkout hardlinks instead of copies (handle with care)

- **--tar**

  Create a tarball from the artifact contents instead of a file tree. If LOCATION is '-', the tarball will be dumped to the standard output.