Get Started

Create your Tenki Account

To get started, head to the Registration Page. From there, you'll create your account and first Workspace and Project:

Install the Tenki GitHub App

Once your onboarding completed you'll get redirected to the Workspace Dashboard. From there select your project:

Click the Connect GitHub button to install the Tenki GitHub App. We’ll then show you which of your Tenki workspaces are connected to your GitHub Organizations, you can click on Continue.

You will require to grants the necessary permissions for Tenki on your Organization:

Next, you’ll choose which GitHub repositories to connect to this Tenki project. You can update these selections later in the Project settings:

Use our Runners: Migration Wizard (Recommended)

To make it super easy to start using our Runners—or to migrate from another solution—we’ve built a Migration Wizard. We highly recommend using it! Click on the following button:

From there, select your repository. We’ll automatically detect the runners you’re currently using. All you need to do is choose the Tenki Runner you want to switch to. Once selected, you can generate the pull request and click to view it:

Once you’ve reviewed your pull request, go ahead and merge it—you’ll then see your first workflows running on Tenki Runners 🎊

Use our Runners: 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 — no other changes needed:

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

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

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