# Manage Runners

> Manage Runners creates, pauses and schedules GitLab runners on Hetzner Cloud, from a dashboard or the manage-runners CLI.

Every documentation page is available as Markdown at the URLs below. Agents operating the CLI should start with the agent guide and follow its safety rules. The whole documentation in one file: https://managerunners.com/llms-full.txt

## Get started

- [Manage Runners documentation](https://managerunners.com/docs/index.md): Run your own GitLab CI/CD runners on Hetzner Cloud, managed from a dashboard or the manage-runners CLI.
- [Quick start](https://managerunners.com/docs/quickstart/index.md): Create an account, connect Hetzner and GitLab, start your first runner and run a job on it.

## Manual

- [Manual](https://managerunners.com/docs/manual/index.md): Everything you can do with Manage Runners and what you need to know to do it safely.
- [Concepts](https://managerunners.com/docs/manual/concepts/index.md): Runner states, products and locations, executors, which changes recreate the server, and what you pay for.
- [Hetzner setup](https://managerunners.com/docs/manual/hetzner/index.md): Create the Hetzner Cloud API token, and learn what Manage Runners creates in your project and how to use SSH keys, labels and firewalls.
- [GitLab setup](https://managerunners.com/docs/manual/gitlab/index.md): Create a runner authentication token, choose tags, and connect runners to GitLab.com or a self-managed GitLab instance.
- [Runners](https://managerunners.com/docs/manual/runners/index.md): Create, edit, duplicate, pause, resume, delete and remove runners in the dashboard.
- [Schedules](https://managerunners.com/docs/manual/schedules/index.md): Pause and resume runners automatically on a weekly timetable to save server costs.
- [Monitoring](https://managerunners.com/docs/manual/monitoring/index.md): See CPU, RAM and disk usage of your runners in the dashboard, and what monitoring installs on the server.
- [Organizations](https://managerunners.com/docs/manual/organizations/index.md): Share runners with your team, assign roles, invite members and switch between organizations.
- [Personal access tokens](https://managerunners.com/docs/manual/access-tokens/index.md): Create scoped, expiring tokens for the CLI, scripts, CI jobs and AI agents, and revoke them.
- [Account security](https://managerunners.com/docs/manual/account-security/index.md): Two-factor authentication, password rules, sign-in lockout, changing and resetting your password.
- [Billing and plans](https://managerunners.com/docs/manual/billing/index.md): Plans and what they include, checkout, upgrades and downgrades, payment methods, and what the owner manages.
- [Troubleshooting](https://managerunners.com/docs/manual/troubleshooting/index.md): What to do when a runner is stuck, unknown or rejected, jobs don't start, or the dashboard refuses an action.

## CLI

- [manage-runners CLI](https://managerunners.com/docs/cli/index.md): Manage runners, schedules and monitoring from your terminal, scripts and AI agents with the official manage-runners CLI.
- [Install the CLI](https://managerunners.com/docs/cli/install/index.md): Install, verify, upgrade and uninstall the manage-runners CLI on Linux, macOS and Windows, and set up shell completion.
- [Log in and authenticate](https://managerunners.com/docs/cli/authentication/index.md): Log in with your password and 2FA, grant write scopes, import tokens, and use the CLI on headless systems and in CI.
- [Profiles and organizations](https://managerunners.com/docs/cli/profiles-and-organizations/index.md): Keep several API profiles, switch the default profile, and choose the organization your commands work in.
- [Manage runners with the CLI](https://managerunners.com/docs/cli/runners/index.md): List, create, update, pause, resume, duplicate and delete runners, wait for them, and read their metrics from the terminal.
- [Schedules with the CLI](https://managerunners.com/docs/cli/schedules/index.md): Create, read, enable, disable and delete runner schedules from the terminal.
- [The CLI for AI agents and automation](https://managerunners.com/docs/cli/agents/index.md): Agent mode, command discovery, the JSON contract, exit and error codes, confirmations, scopes, and the embedded agent skill.
- [CLI command reference](https://managerunners.com/docs/cli/reference/index.md): Every manage-runners 1.0.1 command with its scopes, safety properties and help text.

## CLI command reference

- [manage-runners commands](https://managerunners.com/docs/cli/reference/commands/index.md): List CLI commands
- [manage-runners help](https://managerunners.com/docs/cli/reference/help/index.md): Show command help
- [manage-runners version](https://managerunners.com/docs/cli/reference/version/index.md): Show CLI version metadata; --check compares it with the latest release
- [manage-runners self-update](https://managerunners.com/docs/cli/reference/self-update/index.md): Replace this binary with the latest release, or --version, after verifying its SHA-256
- [manage-runners config show](https://managerunners.com/docs/cli/reference/config-show/index.md): Show effective non-secret configuration
- [manage-runners config profiles](https://managerunners.com/docs/cli/reference/config-profiles/index.md): List configured API profiles
- [manage-runners config set-api](https://managerunners.com/docs/cli/reference/config-set-api/index.md): Store an API origin after HTTPS validation; the default profile otherwise uses https://api.managerunners.com
- [manage-runners completion](https://managerunners.com/docs/cli/reference/completion/index.md): Generate shell completion scripts
- [manage-runners setup](https://managerunners.com/docs/cli/reference/setup/index.md): Run the human setup wizard
- [manage-runners setup skill](https://managerunners.com/docs/cli/reference/setup-skill/index.md): Install or manage the embedded agent skill
- [manage-runners doctor](https://managerunners.com/docs/cli/reference/doctor/index.md): Run read-only diagnostics
- [manage-runners auth login](https://managerunners.com/docs/cli/reference/auth-login/index.md): Store a PAT from stdin or a named environment variable
- [manage-runners auth status](https://managerunners.com/docs/cli/reference/auth-status/index.md): Show authentication status without printing the token
- [manage-runners auth logout](https://managerunners.com/docs/cli/reference/auth-logout/index.md): Remove the local credential; optionally revoke the current PAT
- [manage-runners auth profiles](https://managerunners.com/docs/cli/reference/auth-profiles/index.md): List local profiles without credentials
- [manage-runners auth use](https://managerunners.com/docs/cli/reference/auth-use/index.md): Select the default profile
- [manage-runners runner list](https://managerunners.com/docs/cli/reference/runner-list/index.md): List owned runners
- [manage-runners runner get](https://managerunners.com/docs/cli/reference/runner-get/index.md): Get one runner by exact ID or unique name
- [manage-runners runner watch](https://managerunners.com/docs/cli/reference/runner-watch/index.md): Poll a runner until a target or terminal state
- [manage-runners runner metrics](https://managerunners.com/docs/cli/reference/runner-metrics/index.md): Show resource monitoring metrics for one or all monitored runners
- [manage-runners runner ssh-keys](https://managerunners.com/docs/cli/reference/runner-ssh-keys/index.md): List SSH keys available through the runner provider credential
- [manage-runners runner create](https://managerunners.com/docs/cli/reference/runner-create/index.md): Create one runner; may create paid Hetzner resources
- [manage-runners runner update](https://managerunners.com/docs/cli/reference/runner-update/index.md): Update one runner; product, GitLab host, runner token, concurrency, executor, SSH key or monitoring changes recreate an active runner's VM
- [manage-runners runner pause](https://managerunners.com/docs/cli/reference/runner-pause/index.md): Pause a runner and delete its active VM
- [manage-runners runner resume](https://managerunners.com/docs/cli/reference/runner-resume/index.md): Resume a paused runner; may create paid Hetzner resources
- [manage-runners runner duplicate](https://managerunners.com/docs/cli/reference/runner-duplicate/index.md): Duplicate a runner; may create paid Hetzner resources
- [manage-runners runner delete](https://managerunners.com/docs/cli/reference/runner-delete/index.md): Delete an active or paused runner
- [manage-runners runner forget](https://managerunners.com/docs/cli/reference/runner-forget/index.md): Remove only an UNKNOWN dashboard record
- [manage-runners runner wait](https://managerunners.com/docs/cli/reference/runner-wait/index.md): Wait for a runner target state after a mutation
- [manage-runners schedule get](https://managerunners.com/docs/cli/reference/schedule-get/index.md): Read a runner schedule
- [manage-runners schedule set](https://managerunners.com/docs/cli/reference/schedule-set/index.md): Create or replace a runner schedule
- [manage-runners schedule enable](https://managerunners.com/docs/cli/reference/schedule-enable/index.md): Enable an existing schedule
- [manage-runners schedule disable](https://managerunners.com/docs/cli/reference/schedule-disable/index.md): Disable a schedule without deleting it
- [manage-runners schedule delete](https://managerunners.com/docs/cli/reference/schedule-delete/index.md): Permanently delete a schedule
- [manage-runners product list](https://managerunners.com/docs/cli/reference/product-list/index.md): List GitLab runner products
- [manage-runners product get](https://managerunners.com/docs/cli/reference/product-get/index.md): Get one product by exact ID
- [manage-runners product locations](https://managerunners.com/docs/cli/reference/product-locations/index.md): Show bookable datacenters and prices for a product
- [manage-runners provider hetzner ssh-keys](https://managerunners.com/docs/cli/reference/provider-hetzner-ssh-keys/index.md): Validate a Hetzner token and list SSH keys
- [manage-runners profile show](https://managerunners.com/docs/cli/reference/profile-show/index.md): Show the current non-sensitive user profile
- [manage-runners subscription show](https://managerunners.com/docs/cli/reference/subscription-show/index.md): Show the current subscription and schedule entitlement
- [manage-runners subscription plans](https://managerunners.com/docs/cli/reference/subscription-plans/index.md): List available subscription plans
- [manage-runners org list](https://managerunners.com/docs/cli/reference/org-list/index.md): List your organizations with role and default marker
- [manage-runners org use](https://managerunners.com/docs/cli/reference/org-use/index.md): Store the organization for the profile's organization-scoped commands, or clear it