# Quickstart (https://tenki.cloud/docs/runners/quickstart)

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

Install the Tenki GitHub App, switch one line in your workflow, and your jobs run on Tenki.
Caching works out of the box.

Tenki Runners are a drop-in replacement for GitHub-hosted runners: the only workflow change is the `runs-on` value. This guide takes you from sign-up to your first job on Tenki in a few minutes.

**Step 1:**
## Connect your GitHub organization

[Create a Tenki account](https://app.tenki.cloud/auth/registration/) (email or GitHub), then open the [dashboard](https://app.tenki.cloud), select **Runners**, and start the GitHub connection. On GitHub, choose which repositories Tenki can access and select **Install & Authorize**:

![GitHub installation page for selecting Tenki Runners repository access](https://tenki.cloud/images/get-started/github-install.png)

**Step 2:**
## Switch your workflows to Tenki

The fastest path is the **Migration Wizard**: in the Runners dashboard, select a repository and it detects every workflow's current runner, lets you pick a Tenki size per job, and opens a pull request with the changes. Merge it and your jobs run on Tenki.

[Video](https://storage.googleapis.com/tenki-cloud-assets/docs/tenki_step3_migration_wizard.mp4)

The wizard never touches anything other than `runs-on`. Workflows it can't rewrite safely (YAML anchors, multi-line `runs-on` values) are skipped and listed in the result so you can edit them by hand.

To migrate manually instead, replace the runner tag in `.github/workflows/*.yml`:

```yaml
jobs:
  build:
-    runs-on: ubuntu-latest
+    runs-on: tenki-standard-medium-4c-8g
```

Migrating from self-hosted runners? Replace the entire `runs-on` value—including any label array—with one Tenki label.

See [Runner Sizes & Labels](https://tenki.cloud/docs/runners/sizes.md) for available labels, or [Which runner should I use?](https://tenki.cloud/docs/runners/which-runner-should-i-use.md) for sizing guidance.

**Step 3:**
## Run your first job

Merge the Migration Wizard pull request—or commit your manual edit—then trigger the workflow as you normally do. In GitHub's **Actions** tab, open the run and confirm the job completes on the Tenki label you selected.

Existing `actions/cache` steps keep working unchanged, and package downloads from npm, apt, Go modules, Maven, and other registries are cached automatically. See [Caching](https://tenki.cloud/docs/runners/caching.md) for quotas and details.

***

## Next steps

* [Runner Sizes & Labels](https://tenki.cloud/docs/runners/sizes.md): standard labels and specifications
* [Caching](https://tenki.cloud/docs/runners/caching.md): the hosted Actions cache and dependency mirrors
* [Limits & Concurrency](https://tenki.cloud/docs/runners/limits-and-concurrency.md): what to expect at peak load
* [Networking & Egress](https://tenki.cloud/docs/runners/networking.md): egress IPs and private connectivity
* [Security & Isolation](https://tenki.cloud/docs/trust/security.md): ephemeral VMs and the isolation model

Hit a snag, like your organization not showing up or jobs stuck in queue? See [Troubleshooting](https://tenki.cloud/docs/runners/troubleshooting.md).