Runners
The Runners page lists the continuous-integration runners registered with the instance and lets you add new ones and remove old ones. A runner is a machine that picks up and executes pipeline jobs. From this page you register a runner and receive its one-time registration token, watch each runner's status and when it was last seen, and deregister a runner when you retire it.
Where to find it
- URL:
gitvetrix.com/admin/runners - Navigation: In the admin area, open the Operations group in the sidebar and select Runners.
Review the runner list
The page opens with a table titled CI Runners that lists every registered runner, one per row, with these columns:
- Name — the name you gave the runner when you registered it.
- ID — the first part of the runner's identifier.
- Status — a badge reading Idle, Busy, or Offline. A runner whose status cannot be read shows Unknown.
- Tags — the capability tags assigned to the runner, or No tags.
- Last seen — how long ago the runner last contacted the instance, or Never.
- Registered — how long ago the runner was registered.
- Actions — a deregister button marked with a trash icon.
When no runners are registered, the page shows No runners registered with a note inviting you to register your first runner.
Register a runner
- Select Register runner in the top-right corner.
- In the Register CI runner dialog, enter a Runner name.
- Optionally fill in Tags (comma-separated, optional) to describe the runner's capabilities, such as
docker, linux, gpu. Tags are used to match jobs that require specific capabilities. - Select Register.
The new runner appears in the list, and a highlighted panel shows the runner's registration token once. The panel warns Runner registered — copy the token now. This will not be shown again.
- Select Copy to copy the token, or select the token value and copy it yourself.
- The panel notes that the token is passed to the runner through an environment variable. Provide the token to the runner before you dismiss the panel.
- Select the dismiss control to close the panel.
The token is shown only this once. If you lose it, deregister the runner and register a new one to get a fresh token.
Deregister a runner
Deregistering a runner stops it from accepting any further jobs.
- In the runner's row, select the deregister button (the trash icon).
- In the Deregister runner dialog, type the runner's name to confirm.
- Select Deregister runner to remove it.
If the runner cannot be removed, a message asks you to try again.