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

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

Set up Tenki Runners in minutes. Install the GitHub App and supercharge your workflows with the step-by-step Migration Wizard.

**Step 1:**
## Create your Tenki account

Open the [Tenki registration page](https://app.tenki.cloud/auth/registration/) and register with email and password or GitHub.

![Tenki registration page with email and GitHub sign-up options](https://tenki.cloud/images/get-started/account-creation.png)

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

**Step 2:**
## Install the Tenki GitHub App

Open the [Tenki dashboard](https://app.tenki.cloud), choose the workspace and project you want to connect, select **Runners**, and start the GitHub connection. Install the Tenki Runners GitHub App for your organization:

![Tenki Runners dashboard prompting you to connect a GitHub organization](https://tenki.cloud/images/get-started/aiow-step1.png)

On GitHub, choose the repositories Tenki can access, then select **Install & Authorize**:

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

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

> **Important:** A Tenki Workspace can be connected to only one GitHub Organization and vice-versa.

Choose one migration path: use the Migration Wizard (3A), or update the workflow manually (3B).

**Step 3A:**
## Migrate with the Migration Wizard (recommended)

In the Tenki Runners dashboard, open **Migration Wizard** and select the repository:

![Migration Wizard repository selection in the Tenki Runners dashboard](https://tenki.cloud/images/get-started/aiow-mw-1.png)

We'll detect your current runners automatically. Next, select the Tenki Runner you want to switch to:

![Migration Wizard showing detected GitHub-hosted runners and Tenki replacement options](https://tenki.cloud/images/get-started/aiow-mw-2.png)

Then we'll generate a pull request for you to review and merge.

![Migration Wizard previewing the pull request it will create](https://tenki.cloud/images/get-started/aiow-mw-3.png)

After you review and merge the pull request, the workflow runs on Tenki Runners.

![Tenki Runners dashboard showing a migrated workflow job](https://tenki.cloud/images/get-started/aiow-mw-4.png)

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

**Step 3B:**
## Migrate the workflow manually

GitHub Actions use the `runs-on` field in workflow files (located in `.github/workflows`) to determine which runner to use.

After the repository is connected through the Tenki Runners GitHub App, the only workflow-file change is replacing the existing runner tag with a Tenki runner tag:

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

Tenki currently offers the following configurations:

| **Instance Type**                 | **Compute** | **Memory** |
| --------------------------------- | ----------- | ---------- |
| tenki-standard-autoscale          | dynamic     | dynamic    |
| tenki-standard-small-2c-4g        | 2 vCPU      | 4 GB       |
| tenki-standard-medium-4c-8g       | 4 vCPU      | 8 GB       |
| tenki-standard-large-8c-16g       | 8 vCPU      | 16 GB      |
| tenki-standard-large-plus-16c-32g | 16 vCPU     | 32 GB      |

The Starter plan supports runner sizes up to 4 vCPU / 8 GB RAM. Larger sizes require Team or Enterprise; see [Pricing](https://tenki.cloud/docs/pricing.md).

> **Custom configuration ?:** Can't find the configuration you need? Reach out to us at hello@tenki.cloud, our team will be glad to create a custom solution tailored to your needs.

To make integration easier, we've added a dedicated view on the Runners page. From there, you can quickly copy the runner tag and paste it directly into your workflow file.

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

***

## Next steps

Once your first jobs are running on Tenki, common things to set up:

* [Limits, Concurrency & Cold Start](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
* [Secrets](https://tenki.cloud/docs/runners/secrets-and-signing.md), how Tenki handles GitHub Actions secrets
* [Android Emulator](https://tenki.cloud/docs/runners/android-emulator.md), KVM nested virtualization for UI tests
* [macOS Xcode & Custom Images](https://tenki.cloud/docs/runners/macos-xcode-and-images.md), Xcode pinning and custom images
* [Security & Isolation](https://tenki.cloud/docs/trust/security.md), ephemeral VMs and the isolation model

***

## Troubleshooting

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

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