OS Manuals

/usr/bin/manager

Kubernetes controller for GitHub Actions self-hosted runners

From actions-runner-controller 0.14.2-r3 (os), captured 2026-11-05 by running manager --help (exit 0). permalink

Also provided by 150 other package versions
Usage of /usr/bin/manager:
  -auto-scaler-image-pull-secrets value
    	The default image-pull secret name for auto-scaler listener container.
  -auto-scaling-runner-set-only
    	Make controller only reconcile AutoRunnerScaleSet object.
  -common-runner-labels value
    	Runner labels in the K1=V1,K2=V2,... format that are inherited all the runners created by the controller. See https://github.com/actions/actions-runner-controller/issues/321 for more information
  -default-scale-down-delay duration
    	The approximate delay for a scale down followed by a scale up, used to prevent flapping (down->up->down->... loop) (default 10m0s)
  -docker-gid string
    	The default GID of docker group in the docker sidecar container. Use 1001 for dockerd sidecars of Ubuntu 20.04 runners 121 for Ubuntu 22.04 and 24.04. (default "1001")
  -docker-image string
    	The image name of docker sidecar container to use by default if one isn't defined in yaml. (default "docker:dind")
  -docker-registry-mirror string
    	The default Docker Registry Mirror used by runners.
  -enable-leader-election
    	Enable leader election for controller manager. Enabling this will ensure there is only one active controller manager.
  -exclude-label-propagation-prefix value
    	The list of prefixes that should be excluded from label propagation
  -github-app-id int
    	The application ID of GitHub App.
  -github-app-installation-id int
    	The installation ID of GitHub App.
  -github-app-private-key string
    	The path of a private key file to authenticate as a GitHub App
  -github-basicauth-password string
    	Password for GitHub basic auth to use instead of PAT or GitHub APP in case it's running behind a proxy API
  -github-basicauth-username string
    	Username for GitHub basic auth to use instead of PAT or GitHub APP in case it's running behind a proxy API
  -github-enterprise-url string
    	Enterprise URL to be used for your GitHub API calls
  -github-token string
    	The personal access token of GitHub.
  -github-upload-url string
    	GitHub Upload URL to be used for GitHub API calls
  -github-url string
    	GitHub URL to be used for GitHub API calls
  -health-probe-bind-address string
    	The address the health probe endpoint binds to. Disabled if empty.
  -k8s-client-rate-limiter-burst int
    	The burst value of the K8s client rate limiter. (default 30)
  -k8s-client-rate-limiter-qps int
    	The QPS value of the K8s client rate limiter. (default 20)
  -kubeconfig string
    	Paths to a kubeconfig. Only required if out-of-cluster.
  -leader-election-id string
    	Controller id for leader election. (default "actions-runner-controller")
  -listener-metrics-addr string
    	The address applied to AutoscalingListener metrics server (default ":8080")
  -listener-metrics-endpoint string
    	The AutoscalingListener metrics server endpoint from which the metrics are collected (default "/metrics")
  -log-format string
    	The log format. Valid options are "text" and "json". Defaults to "text" (default "text")
  -log-level string
    	The verbosity of the logging. Valid values are "debug", "info", "warn", "error". Defaults to "debug". (default "debug")
  -metrics-addr string
    	The address the metric endpoint binds to. (default ":8080")
  -port int
    	The port to which the admission webhook endpoint should bind (default 9443)
  -pprof-addr string
    	The address the pprof endpoint binds to.
  -runner-github-url string
    	GitHub URL to be used by runners during registration
  -runner-image string
    	The image name of self-hosted runner container to use by default if one isn't defined in yaml. (default "summerwind/actions-runner:latest")
  -runner-image-pull-secret value
    	The default image-pull secret name for self-hosted runner container.
  -runner-max-concurrent-reconciles int
    	The maximum number of concurrent reconciles which can be run by the EphemeralRunner controller. Increase this value to improve the throughput of the controller, but it may also increase the load on the API server and the external service (e.g. GitHub API). (default 2)
  -runner-status-update-hook
    	Use custom RBAC for runners (role, role binding and service account).
  -sync-period duration
    	Determines the minimum frequency at which K8s resources managed by this controller are reconciled. (default 1m0s)
  -update-strategy string
    	Resources reconciliation strategy on upgrade with running/pending jobs. Valid values are: "immediate", "eventual". Defaults to "immediate". (default "immediate")
  -watch-namespace string
    	The namespace to watch for custom resources. Set to empty for letting it watch for all namespaces.
  -watch-single-namespace string
    	Restrict to watch for custom resources in a single namespace.
  -workqueue-rate-limiter string
    	The workqueue rate limiter to use. Valid values are "bucket_rate_limiter" (default) and "typed_rate_limiter" (per-item only, no global token bucket).
Options (40)
OptionDescriptionSource
-auto-scaler-image-pull-secrets valueThe default image-pull secret name for auto-scaler listener container.help
-auto-scaling-runner-set-onlyMake controller only reconcile AutoRunnerScaleSet object.help
-common-runner-labels valueRunner labels in the K1=V1,K2=V2,...help
-default-scale-down-delay durationThe approximate delay for a scale down followed by a scale up, used to prevent flapping (down->up->down->...help
-docker-gid stringThe default GID of docker group in the docker sidecar container.help
-docker-image stringThe image name of docker sidecar container to use by default if one isn't defined in yaml.help
-docker-registry-mirror stringThe default Docker Registry Mirror used by runners.help
-enable-leader-electionEnable leader election for controller manager.help
-exclude-label-propagation-prefix valueThe list of prefixes that should be excluded from label propagationhelp
-github-app-id intThe application ID of GitHub App.help
-github-app-installation-id intThe installation ID of GitHub App.help
-github-app-private-key stringThe path of a private key file to authenticate as a GitHub Apphelp
-github-basicauth-password stringPassword for GitHub basic auth to use instead of PAT or GitHub APP in case it's running behind a proxy APIhelp
-github-basicauth-username stringUsername for GitHub basic auth to use instead of PAT or GitHub APP in case it's running behind a proxy APIhelp
-github-enterprise-url stringEnterprise URL to be used for your GitHub API callshelp
-github-token stringThe personal access token of GitHub.help
-github-upload-url stringGitHub Upload URL to be used for GitHub API callshelp
-github-url stringGitHub URL to be used for GitHub API callshelp
-health-probe-bind-address stringThe address the health probe endpoint binds to.help
-k8s-client-rate-limiter-burst intThe burst value of the K8s client rate limiter.help
-k8s-client-rate-limiter-qps intThe QPS value of the K8s client rate limiter.help
-kubeconfig stringPaths to a kubeconfig.help
-leader-election-id stringController id for leader election.help
-listener-metrics-addr stringThe address applied to AutoscalingListener metrics server (default ":8080")help
-listener-metrics-endpoint stringThe AutoscalingListener metrics server endpoint from which the metrics are collected (default "/metrics")help
-log-format stringThe log format.help
-log-level stringThe verbosity of the logging.help
-metrics-addr stringThe address the metric endpoint binds to.help
-port intThe port to which the admission webhook endpoint should bind (default 9443)help
-pprof-addr stringThe address the pprof endpoint binds to.help
-runner-github-url stringGitHub URL to be used by runners during registrationhelp
-runner-image stringThe image name of self-hosted runner container to use by default if one isn't defined in yaml.help
-runner-image-pull-secret valueThe default image-pull secret name for self-hosted runner container.help
-runner-max-concurrent-reconciles intThe maximum number of concurrent reconciles which can be run by the EphemeralRunner controller.help
-runner-status-update-hookUse custom RBAC for runners (role, role binding and service account).help
-sync-period durationDetermines the minimum frequency at which K8s resources managed by this controller are reconciled.help
-update-strategy stringResources reconciliation strategy on upgrade with running/pending jobs.help
-watch-namespace stringThe namespace to watch for custom resources.help
-watch-single-namespace stringRestrict to watch for custom resources in a single namespace.help
-workqueue-rate-limiter stringThe workqueue rate limiter to use.help

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.