---
title: "Troubleshooting 9apes GitHub Actions Runners"
description: "Fix common 9apes setup issues including queued jobs, missing runner labels, GitHub App permissions, repository access, and support paths."
url: https://9apes.com/docs/troubleshooting/
---

# Troubleshooting 9apes GitHub Actions Runners

Contact [support@9apes.com](mailto:support@9apes.com) for help with any issues.

## Job did not start

Symptoms:

- The job stays queued.
- GitHub says it is waiting for a runner.
- The workflow never appears in 9apes.

Check:

- The GitHub App is installed for the repository.
- The workflow uses a supported `runs-on` label from [Available Runners](https://9apes.com/docs/available-runners/).
- The repository is connected in 9apes.
- The workflow was triggered after the GitHub App was installed.

## Runner label not found

Symptoms:

- GitHub cannot match the `runs-on` label.
- The job waits even though other jobs are running.

Check:

- The label is spelled exactly as [documented](https://9apes.com/docs/available-runners/).
- The label is available for your organization or repository.

## Permission or GitHub App errors

Symptoms:

- 9apes cannot see the repository.
- The job cannot start after installation.
- GitHub App installation appears incomplete.

Check:

- The GitHub App is installed on the correct organization.
- The repository is selected in the app installation.
- You have permission to manage GitHub Apps for the organization or repository.
- Required permissions match [GitHub App Permissions](https://9apes.com/security/#github-app-permissions).

## Getting support

Contact [support@9apes.com](mailto:support@9apes.com) for help with any issues.

## Related pages

- [Available Runners](https://9apes.com/docs/available-runners/) — check the label you used against the supported list
- [Quick Start](https://9apes.com/docs/quick-start/) — the full setup path, including how to roll back
- [GitHub Actions runner pricing](https://9apes.com/pricing/) — rates, free minutes, and where to review usage