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

Create your Tenki account

Open the Tenki registration page and register with email and password or GitHub.

Install the Tenki GitHub App

Open the Tenki dashboard, 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

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

GitHub installation page for selecting Tenki Runners repository access

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

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

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

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

Migration Wizard previewing the pull request it will create

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

Tenki Runners dashboard showing a migrated workflow job

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:

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.

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.

Next steps

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

Limits, Concurrency & Cold Start, what to expect at peak load
Networking & Egress, egress IPs and private connectivity
Secrets, how Tenki handles GitHub Actions secrets
Android Emulator, KVM nested virtualization for UI tests
macOS Xcode & Custom Images, Xcode pinning and custom images
Security & Isolation, 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 and we'll be happy to help.

Quickstart