Prerequisites

  1. A Container Engine: You will need Docker installed on your machine. Install Docker here.

  2. Blink User: You must have either the Owner role,Contributor role, or a custom role that includes both the runners:view and runners:edit permissions. To learn more about role-based access and permissions, see the User Roles documentation.


Requirements

When deploying self-hosted runners on a hardened OS, it’s crucial to ensure proper communication between Docker containers, therefor please implement the following requirements:

RequirementExplanation
Manage internal firewall settingsAn internal firewall might prevent communication between containers. To resolve this, create a firewall rule that allows containers to communicate with each other internally. The port used for internal container communication is selected randomly, so the firewall rule must accommodate this configuration/requirements
Ensure sufficient disk spaceEnsure that your system has at least 30GB of available disk space on the /var partition to avoid deployment issues.
Verify DNS server configurationEnsure that all DNS servers configured on your system are correctly resolving addresses, as DNS issues could impact network operations during deployment.

Deployment Guide

1

Navigate to the Runners page

In the left-hand navigation bar, select Runners. Then, click the New Runner button in the top-right corner to open the configuration dialog.

2

Fill in the parameters:

Fill in the required details:

  • Name: Enter a name for the Runner group.
  • Tags: Add or create tags (optional).
  • Default: Check this box to set this Runner group as the default. When enabled, any workflows that do not explicitly specify a Runner group will automatically be assigned to this one.
3

Choose Runner Type

Choose Docker as your runner type.

4

Copy and save the command

Click ‘Continue’. to proceed. A dialog box will appear with the command needed to install the Runner in your Docker environment. To copy the command, click the button in the top-right corner.

WARNING

Please be aware that the provided command contains the registration token of the Runner, which will not be retrievable after copying. It is essential to securely store this token in a safe location for future reference.