Install the Tenki GitHub App

To get started, head to app.tenki.cloud, select a project, and navigate to the Runners page. From there, follow the prompts to install the Tenki GitHub App, which grants the necessary permissions for Tenki to run your GitHub Actions on our infrastructure.

🛰️ Note: Tenki supports both GitHub organizations and personal repositories.

Link your GitHub repositories to your Tenki Project

To make it easier to manage multiple projects or varying scopes, we've created a direct link between your GitHub repositories and your Tenki project. That's why, immediately after installing the application, you'll be redirected back to Tenki and prompted to select the repositories you want associated with this project.

You can always update your selections later by navigating to the Repositories tab and managing them from the GitHub Repositories table.

Update Your Workflow Files to Use Tenki Runners

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. Tenki is a drop-in replacement for GitHub's hosted runners—no other changes needed.

Example:

Switch from ubuntu-latest to a 2 vCPU Tenki runner:

jobs:
  build:
-    runs-on: ubuntu-latest
+    runs-on: tenki-standard-small-2c-2g

Tenki runners are offered in 2, 4, 8, 16, and 32 vCPU configurations.

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

You can also explore and use all available offering here: