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

# Troubleshooting

> Fix common Coreload problems: jobs that wait for a runner, labels that don't match, and setup steps that fail.

## A job doesn't start

* **Your organization isn't turned on yet.** After you install the App, we turn your organization on by hand, and
  jobs wait until then.
* **The label.** It must be exactly one Coreload label, one we sent you, with nothing else in `runs-on`.
* **The repository.** It must be private, and selected in the App's repository list (**Settings > GitHub Apps >
  Coreload CI > Configure**).
* **The runner group.** Coreload's runner group in **Settings > Actions > Runner groups** must be left as we set it.
  Widened, it serves nothing until it matches again.

## A job is slow

* Move it to a bigger size, if your organization has one; see [Runners and labels](https://docs.coreload.com/runners.md).

## A step fails

A job that starts but fails on a step its old runner passed usually needs something the Coreload image doesn't have
yet. See [Languages and tools](https://docs.coreload.com/languages.md) for what works.

**No Docker yet.** A step that runs `docker` fails because the command is not found, and a job with `container:` or
`services:` can't start. Keep these jobs on their current runner for now.

**A setup action that downloads an Ubuntu build.** `actions/setup-python` failed for the CPython versions our benchmark
runs tried (the [quickstart](https://docs.coreload.com/quickstart.md) lists them) when it downloaded them. Keep the job on its current runner for
now.

```text theme={null}
... not found for debian 12
```

**A tool that isn't preinstalled.** Go and Rust aren't, so a step that runs `go` without installing it fails. Our run
recorded `spawn go ENOENT` from a step that starts `go` from Node.js (a JavaScript action or script). Add
`actions/setup-go` before it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.