# Troubleshooting (https://tenki.cloud/docs/runners/troubleshooting)

> For the complete documentation index, see [llms.txt](https://tenki.cloud/llms.txt)

Diagnose common Tenki Runner setup, queue, cancellation, resource, and repository-access issues.

This page collects the most common issues teams hit when setting up Tenki Runners, along with the fastest way to resolve each one. If you're still blocked after working through the relevant section, we're one email away.

## My organization isn't showing up in Tenki

Not seeing your organization in the Tenki dashboard? Here are a few things to check:

* The Tenki GitHub App isn't installed on your GitHub Organization. Make sure it's properly installed. (Settings > Applications > Installed GitHub Apps)
* Your GitHub user isn't a member of the organization. Double-check your access.
* Each Tenki workspace can connect to one GitHub organization, and each GitHub organization can connect to one Tenki workspace. If either is already connected elsewhere, it won't be available for another connection.
* If you selected `Only select repositories` during installation: Make sure you're pushing to a repository that's actually included in your selection. If not, you can update the list anytime from your GitHub settings. See [Manage your GitHub Repositories](https://tenki.cloud/docs/runners/repo-management.md) for how access stays in sync.

## My jobs are stuck as "queued" or never start

When a job stays queued and never picks up a Tenki runner, it's almost always a label or capacity issue:

* **The `runs-on` label doesn't match a Tenki runner.** Confirm your workflow targets a valid Tenki label (for example `tenki-standard-small-2c-4g`). See [Runner Sizes & Labels](https://tenki.cloud/docs/runners/sizes.md) for the standard labels.
* **You've hit your plan's concurrency limit.** Jobs above your concurrent-job ceiling wait for a free slot. Review [Limits & Concurrency](https://tenki.cloud/docs/runners/limits-and-concurrency.md) to see your current limits and how to raise them.
* **The job targets a size above your plan's cap.** On Starter, jobs targeting runners larger than 4 vCPU / 8 GB are blocked rather than queued; switch to a smaller label or upgrade.
* **GitHub Actions is disabled for the repository.** Check **Settings → Actions → General** and ensure Actions are allowed.

## My workflow run was cancelled by Tenki

Tenki cancels a run (and emails the workspace owner) in a few specific cases:

* **`runs-on` mixes a Tenki label with other labels.** `runs-on: [self-hosted, tenki-standard-small-2c-4g]` is not supported; use exactly one Tenki label and nothing else.
* **The workspace's daily spending limit was exceeded.** Raise or remove the limit in billing settings, or wait for the next day.
* **The workspace has no usable credit.** Jobs are rejected before any paid work starts; top up or enable auto-reload in billing.

## My build runs out of memory or is slower than expected

* If a job is killed or thrashes, it likely needs a larger runner. Pick a size with more vCPU/RAM. See [Which runner should I use?](https://tenki.cloud/docs/runners/which-runner-should-i-use.md) and [Linux x64 Runners](https://tenki.cloud/docs/runners/x64-runners.md).
* First-run cold starts and cache behavior are covered in [Limits & Concurrency](https://tenki.cloud/docs/runners/limits-and-concurrency.md). Warm caches significantly reduce repeat-build times.

## Frequently asked questions

**Do I need to change my workflow files to use Tenki?**
No. Tenki is a drop-in replacement for GitHub-hosted runners; you only change the `runs-on` value. Everything else in your workflow stays the same.

**Will switching runner size break my pipeline?**
No. Runner size only affects the compute allocated to the job; your steps and commands are unchanged.

**A repository is missing from Tenki. What do I do?**
Confirm the repo is included in the Tenki GitHub App's repository access list. Changes you make in GitHub sync automatically. See [Manage your GitHub Repositories](https://tenki.cloud/docs/runners/repo-management.md).

Still stuck? Reach out to us at [**hello@tenki.cloud**](mailto:hello@tenki.cloud) and we'll be happy to help.