Configuring Tartelet

After installing Tartelet it must be configured with the virtual machine to run and the credentials needed to register the runners on GitHub.

Adding the GitHub Credentials

Tartelet will automatically register the virtual machine as a runner on a GitHub organization. In order to do this it must be configured with the relevant credentials. Follow the steps below to add the credentials to Tartelet.

ℹ️ Note

If you have already created a GitHub App and you are setting up another host machine, you can reuse the credentials from the existing GitHub App. The credentials do not need to be different for each host machine.

1. Create a GitHub App on your organization. This can be done by under "Developer settings" in your organization's settings or by following this link: https://github.com/organizations/{YOUR_ORGANIZATION_NAME}/settings/apps. Remember to change the link to include the name of your organization.
2. When creating the GitHub App, make sure to give it read/write permissions to the self-hosted runners and to disable the webhook.
3. Select "Generate a private key". Tartelet will use this to send authorized requests to the API. The generated key should automatically be downloaded.
4. Transfer the generated private key to your host machine. If you are using VNC, the private key can be dragged on top of the VNC window to transfer it.
5. Launch Tartelet, open its settings, and select the GitHub pane.
6. Fill out the name of your organization.
7. Fill out the app ID. This can be found under the GitHub app that you just created.
8. Select the private key file. The file is stored securely in the keychain of the host machine.
9. Make sure to delete the transferred private key from the host machine.

Creating a Virtual machine