# Quickstart (https://tenki.cloud/docs/runners/quick-start-runners)

> 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 [#create-your-tenki-account]

To get started, head to the [Registration Page](https://app.tenki.cloud/auth/registration/). From there, choose Email and Password or Register with GitHub method:

![AccountCreation](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 [#install-the-tenki-github-app]

Next step will be to connect your GitHub Organization to your Workspace by installing the Tenki GitHub application:

![GitHubApplicationInstall](https://tenki.cloud/images/get-started/aiow-step1.png)

Select the level of permissions you want to grant the application and click on Install & Authorize:

![TenkiGithubInstall2](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.

**Step 3:**
Workflow Migration: Migration Wizard (recommended) [#workflow-migration-migration-wizard-recommended]

Now you can start migrating workflow using our native tool: Migration Wizard, first you need to select the repository:

![Migration-Wizard-Step1](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-Step2](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-Step3](https://tenki.cloud/images/get-started/aiow-mw-3.png)

Once reviewed your migration will be completed and you'll see your first workflows now running on Tenki Runners

![Migration-Wizard-Step4](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 3:**
Workflow Migration: manual migration [#workflow-migration-manual-migration]

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

To switch to a Tenki runner, replace 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      |

> **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 [#next-steps]

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

* [Limits, Concurrency & Cold Start](/docs/runners/limits-and-concurrency), what to expect at peak load
* [Networking & Egress](/docs/runners/networking), egress IPs and private connectivity
* [Secrets](/docs/runners/secrets-and-signing), how Tenki handles GitHub Actions secrets
* [Android Emulator](/docs/runners/android-emulator), KVM nested virtualization for UI tests
* [macOS Xcode & Custom Images](/docs/runners/macos-xcode-and-images), Xcode pinning and custom images
* [Security & Isolation](/docs/trust/security), ephemeral VMs and the isolation model

***

Troubleshooting [#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.