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

# kas-build(1)

kas build plugin

## NAME

kas-build - kas build plugin

## SYNOPSIS

```
kas build [-h] [--skip STEP] [--force-checkout] [--update] [-k]
          [--target TARGET] [-c TASK] [--provenance {true,mode=min,mode=max}]
          [config] [extra_bitbake_args ...]
```

## DESCRIPTION

Checks out all necessary repositories and builds using bitbake as specified in the configuration file.

This plugin implements the **kas build** command.

When this command is executed, kas will checkout repositories, setup the build environment and then invoke bitbake to build the targets selected in the chosen config file.

When running with **--provenance \<true\|mode=...\>** kas will generate an provenance attestation for the build. The attestation will be stored in **attestation/kas-build.provenance.json** in the build directory. For details about provenance, see the build attestation chapter.

**NOTE:**

In provenance mode, the command returns with a non-zero exit code in case no artifact is found for at least one entry.

## OPTIONS

**Positional Arguments**

- **config**

  Config file(s), separated by colon. Using .config.yaml in KAS\_WORK\_DIR if none is specified.

- **extra\_bitbake\_args**

  Extra arguments to pass to bitbake (typically requires separation via '--')

**Named Arguments**

- **--skip=\[\]**

  Skip build steps. To skip more than one step, use this argument multiple times.

  Possible choices: setup\_dir, setup\_home, init\_setup\_repos, repo\_setup\_loop, finish\_setup\_repos, repos\_checkout, repos\_check\_signatures, repos\_apply\_patches, setup\_environ, write\_bbconfig

- **--force-checkout=False**

  Always checkout the desired commit/branch/tag of each repository, discarding any local changes

- **--update=False**

  Pull new upstream changes to the desired branch even if it is already checked out locally

- **-k, --keep-config-unchanged**

  Skip steps that change the configuration

- **--target**

  Select target to build

- **-c, --cmd, --task**

  Select which task should be executed

- **--provenance**

  Enable provenance attestation generation

  Possible choices: true, mode=min, mode=max

## SEE ALSO

**[kas-build-attestation(1)](/kas-build-attestation/1.md)**,

### KAS

Part of the **[kas(1)](/kas/1.md)** suite.

## AUTHOR

Daniel Wagner, Jan Kiszka, Claudius Heine

## COPYRIGHT

Siemens and contributors, 2017-2025