> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trunk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

> Set up Trunk, add Dynamic CI to your CI provider, then turn on enforcement.

> [!WARNING]
>
> Dynamic CI is in **private beta**. [Reach out to Trunk](https://slack.trunk.io) for access.

**1. [Set up Trunk CI](https://docs.trunk.io/ci/get-started): this allows trunk to learn the performance, reliability and runtime behavior of your CI jobs. Critical for making informed decisions on which jobs to skip.**

decides from your CI history. Follow [Set up Trunk CI](https://docs.trunk.io/ci/get-started) for your provider, then [create an API key](https://docs.trunk.io/api/authentication#create-an-api-key) in [Settings → Developer → API Keys](https://app.trunk.io/settings/developer/api-tokens).

**2. Add your API key to GitHub secrets: [Create an API key](https://docs.trunk.io/api/authentication#create-an-api-key) and store it as a repository secret named `TRUNK_API_TOKEN`**

When you create it, select the **Generate Dynamic CI plans** permission. A new key has no permissions, and without this one Trunk refuses every plan request and every job runs.

**3. Add Dynamic CI to your CI**

> [card] [GitHub Actions](https://docs.trunk.io/ci/dynamic-ci/getting-started/github-actions.md)
>
> Add a filter job to your workflow.

> [card] [Buildkite](https://docs.trunk.io/ci/dynamic-ci/getting-started/buildkite.md)
>
> Add the plugin to your pipeline upload.

Your repository starts in **Learning** mode: Trunk records a verdict for
every job and skips nothing.

**4. Turn on enforcement**

When the recommendations look right, open
[Dynamic CI](https://app.trunk.io/dynamic-ci) in the Trunk app, select your
repository, and set the **Dynamic CI mode** to **Enforced**. Only an
organization admin can change it.
