otty / apps
All apps/GitLab Runner

GitLab Runner

gitlab-runner

An application that works with GitLab CI/CD to run jobs in a pipeline.

Runs as gitlab-runner|macOS, Linux, Windows|docs.gitlab.com
Open form in Otty otty.toml

Command form

ai-draft · 3 tasks · 13 fields

Run the runner, register it with a GitLab instance, or verify registered runners. Service management, run-single, executor-specific registration options and token reset are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui gitlab-runner

gitlab-runner run

Run the runner

Fetch and process jobs from GitLab until stopped.

Run the runnerExample values, fixed in this page — nothing here reaches a terminal
Basic
Config file
file
Working directory
directory
TasksEach one presets the form for one job
Run
configworking_directory
ParametersOnly these flags are editable in the form
Config file
path
--config
Working directory
path
--working-directory
Run builds as user
string
--user
Metrics listen address
host:port for the Prometheus metrics server.
string
--listen-address

gitlab-runner register

Register a runner

Register a runner non-interactively with a URL and authentication token.

Register a runnerExample values, fixed in this page — nothing here reaches a terminal
Basic
GitLab URL*
url
Authentication token*
string
Runner name
string
Non-interactive
--non-interactive
TasksEach one presets the form for one job
Register
urltokennamenon_interactive
ParametersOnly these flags are editable in the form
GitLab URL
url
--url
Authentication token
string
--token
Runner name
string
--name
Non-interactive
boolean
--non-interactive
Config file
path
--config

gitlab-runner verify

Verify runners

Check that registered runners can connect to GitLab.

Verify runnersExample values, fixed in this page — nothing here reaches a terminal
Basic
Config file
file
TasksEach one presets the form for one job
Verify all
config
ParametersOnly these flags are editable in the form
GitLab URL
url
--url
Runner token
string
--token
Delete runners that fail verification
boolean
--delete
Config file
path
--config
SourcesEvery flag above is checked against these
docs
gitlab-runner run [command options] [arguments...] --config See configuration-file Specify a custom configuration file to be used --working-directory the current directory Specify the root directory where all data is stored when builds run with the shell executor --user the current user Specify the user that executes builds --syslog false Send all lo…
manual2026-10-27

docs.gitlab.com

docs
gitlab-runner register --name my-runner --url "http://gitlab.example.com" --token my-authentication-token gitlab-runner register --non-interactive <other-arguments> --config See the configuration file section Specify a custom configuration file to be used
manual2026-10-27

docs.gitlab.com

docs
gitlab-runner verify --url "https://gitlab.example.com" --token my-authentication-token gitlab-runner verify --delete --config See the configuration file section Specify a custom configuration file to be used
manual2026-10-27

docs.gitlab.com

Before it fills your prompt, Otty checks the installed gitlab-runner against its version. A form that does not match your version is not offered.