> ## 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.

# Get started

> Turn on Trunk Runners, choose your machine size, and run your first job.

**1. Connect your organization**

[Install the Trunk GitHub and Trunk Runners apps](https://app.trunk.io/settings/organization/github)
on your organization. Then contact Trunk support to add your organization to
the Trunk Runners Beta program.

**2. Move your jobs to Trunk Runners**

In the [Trunk web app](https://app.trunk.io), open **Migrate** on the
**Runners** page. Select your repositories, review the proposed `runs-on`
changes, and approve them. Trunk opens one pull request for each repository.
Merge the pull requests to move the jobs.

You can also change a `runs-on` label by hand. With no options, the job runs
on a machine with 2 CPUs and 8 GiB of memory. See
[The runs-on label](https://docs.trunk.io/runners/actions/runs-on.md).

```yaml theme={"system"}
jobs:
  build:
    runs-on: trunk=${{ github.run_id }}-${{ github.run_attempt }}
    steps:
      - uses: actions/checkout@v4
      - run: make build
```

**3. Run the workflow**

Push a commit or start the workflow. Trunk provisions a fresh VM, runs the
job, and removes the VM when the job ends.

## Next steps

> **[The runs-on label](https://docs.trunk.io/runners/actions/runs-on.md)**
>
> Every option you can set on a job.

> **[Machine sizes](https://docs.trunk.io/runners/actions/sizes.md)**
>
> The sizes, their CPU counts, and the memory options.

> **[Caching](https://docs.trunk.io/runners/cache/index.md)**
>
> Reuse build results to make jobs faster.

> **[Quota and runner priority](https://docs.trunk.io/runners/settings/limits-and-priority.md)**
>
> How CPU quota works, and how to mark priority branches.