--- name: "glab-config" section: "1" platform: "linux" package: "glab" version: "1.126.0-1" release: "Arch Linux 2026-11-01" platforms: ["linux"] url: "https://new.carta.tech/glab-config" --- # glab-config(1) Manage glab settings. ## NAME glab-config - Manage glab settings. ## SYNOPSIS **glab config \[flags\]** ## DESCRIPTION Manage key/value strings. Current respected settings: - • **api\_host**: Configure host for API endpoint. Defaults to the host itself. Also accepted as: **gitlab\_api\_host**. Scoped per host; set it with **--host**. Environment variable: **GITLAB\_API\_HOST**. - • **api\_protocol**: What protocol to use to access the API endpoint. Supported values: **http**, **https**. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_API\_PROTOCOL**, **API\_PROTOCOL**. - • **artifact\_registry\_domains**: The domains of associated Artifact Registries. These are used to configure the Docker credential helper. Only list a domain here if it is actually backed by GitLab Artifact Registry: the credential helper tries this key first, and a successful token exchange is used as-is, with no fallback to container\_registry\_domains. A container-registry domain listed here by mistake gets an artifact-registry token the registry rejects, and **docker pull** hard-fails. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_ARTIFACT\_REGISTRY\_DOMAINS**, **ARTIFACT\_REGISTRY\_DOMAINS**. - • **branch\_prefix**: Prefix used by **glab stack** when naming generated branches. Defaults to the current user's username (from **os/user.Current**), falling back to **glab-stack** if unavailable. Environment variables, first one set wins: **GLAB\_BRANCH\_PREFIX**, **BRANCH\_PREFIX**. - • **browser**: What browser glab should run when opening links. This global config cannot be overridden by hostname. Environment variables, first one set wins: **GLAB\_BROWSER**, **BROWSER**. - • **ca\_cert**: Path to a CA certificate (PEM) used to verify the GitLab server's TLS certificate. Useful for self-signed or private certificate authorities. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_CA\_CERT**, **CA\_CERT**. - • **check\_update**: Allow glab to automatically check for updates and notify you when there are new updates. Setting the environment variable to true also forces a check, bypassing the once-a-day interval. Environment variables, first one set wins: **GLAB\_CHECK\_UPDATE**, **CHECK\_UPDATE**. - • **client\_cert**: Path to a client certificate (PEM) used for mutual TLS authentication. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_CLIENT\_CERT**, **CLIENT\_CERT**. - • **client\_id**: OAuth application client ID. Required when authenticating with OAuth against a self-managed GitLab instance. Scoped per host; set it with **--host**. Environment variable: **GITLAB\_CLIENT\_ID**. - • **client\_key**: Path to the private key (PEM) that matches client\_cert. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_CLIENT\_KEY**, **CLIENT\_KEY**. - • **color**: Set whether glab colors its output. Available options are \[auto, never, always\]. **auto** detects whether the output is a terminal. This key takes precedence over the NO\_COLOR environment variable; NO\_COLOR applies when this is **auto** (or unset). Environment variable: **GLAB\_COLOR**. - • **container\_registry\_domains**: The domains of associated container registries. These are used to configure the Docker credential helper. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_CONTAINER\_REGISTRY\_DOMAINS**, **CONTAINER\_REGISTRY\_DOMAINS**. - • **custom\_headers**: Custom HTTP headers to add to all HTTP requests made by glab. Each header must use exactly one of value, valueFromEnv, or valueFromCommand. A command must print the complete header value on one line. glab runs it once for each process. Scoped per host; set it with **--host**. - • **debug**: Output more logging information, including underlying Git commands, expanded aliases, and DNS error details. Environment variable: **GLAB\_DEBUG**. - • **display\_hyperlinks**: Whether or not to display hyperlinks in terminal output. Defaults to true (enabled for TTYs). Set to false to disable. Force hyperlinks in non-TTY environments by setting FORCE\_HYPERLINKS=1. Environment variables, first one set wins: **GLAB\_DISPLAY\_HYPERLINKS**, **DISPLAY\_HYPERLINKS**. - • **duo\_cli\_auto\_download**: Automatically download Duo CLI binary without prompting (true/false). Environment variables, first one set wins: **GLAB\_DUO\_CLI\_AUTO\_DOWNLOAD**, **DUO\_CLI\_AUTO\_DOWNLOAD**. - • **duo\_cli\_auto\_run**: Automatically run GitLab Duo CLI without prompting (true/false). Set to true to skip the confirmation prompt. Environment variables, first one set wins: **GLAB\_DUO\_CLI\_AUTO\_RUN**, **DUO\_CLI\_AUTO\_RUN**. - • **editor**: What editor glab should run when creating issues, merge requests, etc. This global config cannot be overridden by hostname. Also accepted as: **visual**, **glab\_editor**. Environment variables, first one set wins: **GLAB\_EDITOR**, **VISUAL**, **EDITOR**. - • **git\_protocol**: What protocol to use when performing Git operations. Supported values: **ssh**, **https**. Environment variables, first one set wins: **GLAB\_GIT\_PROTOCOL**, **GIT\_PROTOCOL**. - • **glab\_pager**: Your desired pager command to use, such as **less -R**. Takes precedence over the PAGER environment variable. GLAB\_PAGER takes precedence over both. Environment variable: **GLAB\_PAGER**. - • **glamour\_style**: Set your desired Markdown renderer style. Available options are \[auto, dark, light, notty\]. **auto** detects your terminal's background color. To set a custom style, refer to https://github.com/charmbracelet/glamour#styles. Environment variables, first one set wins: **GLAB\_GLAMOUR\_STYLE**, **GLAMOUR\_STYLE**. - • **host**: Default GitLab hostname to use. Inside a repository, a Git remote on another host takes precedence over the config key. A host from an environment variable, such as **GITLAB\_HOST**, always wins, and glab errors if no remote matches it. Also accepted as: **gitlab\_host**, **gitlab\_uri**, **gl\_host**. Environment variables, first one set wins: **GITLAB\_HOST**, **GITLAB\_URI**, **GL\_HOST**. - • **job\_token**: CI job token used for Job-Token authentication. Typically populated automatically from CI\_JOB\_TOKEN when CI auto-login is enabled. Scoped per host; set it with **--host**. - • **no\_prompt**: Set to true (1) to disable prompts, or false (0) to enable them. Also accepted as: **prompt\_disabled**. Environment variables, first one set wins: **GLAB\_NO\_PROMPT**, **NO\_PROMPT**, **PROMPT\_DISABLED**. - • **notify\_skill\_updates**: Show a notice when an installed agent skill (bundled or remote) has updates available. Environment variable: **GLAB\_NOTIFY\_SKILL\_UPDATES**. - • **orbit\_cli\_auto\_download**: Automatically download the GitLab Orbit CLI binary without prompting (true/false). Environment variables, first one set wins: **GLAB\_ORBIT\_CLI\_AUTO\_DOWNLOAD**, **ORBIT\_CLI\_AUTO\_DOWNLOAD**. - • **orbit\_cli\_auto\_run**: Automatically run the GitLab Orbit CLI without prompting (true/false). Set to true to skip the confirmation prompt. Environment variables, first one set wins: **GLAB\_ORBIT\_CLI\_AUTO\_RUN**, **ORBIT\_CLI\_AUTO\_RUN**. - • **proxy**: Custom proxy for this host. Overrides environment proxy settings when set. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_PROXY**, **PROXY**. - • **remote\_alias**: Name of the **git remote** that points at the GitLab repository. Used to resolve which remote to operate against when multiple are configured. Also accepted as: **git\_remote\_url\_var**, **git\_remote\_alias**, **remote\_nickname**, **git\_remote\_nickname**. Environment variables, first one set wins: **GLAB\_REMOTE\_ALIAS**, **GIT\_REMOTE\_URL\_VAR**, **GIT\_REMOTE\_ALIAS**, **REMOTE\_ALIAS**, **REMOTE\_NICKNAME**, **GIT\_REMOTE\_NICKNAME**. - • **show\_whats\_new**: Show a one-time post-upgrade banner pointing at **glab whatsnew** when a new version is detected. Environment variable: **GLAB\_SHOW\_WHATS\_NEW**. - • **skip\_tls\_verify**: Skip TLS certificate verification when talking to this host (true/false). Empty is treated as false. Use only for development; do not enable in production. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_SKIP\_TLS\_VERIFY**, **SKIP\_TLS\_VERIFY**. - • **ssh\_host**: Alternate hostname for SSH Git operations (e.g., **ssh.example.com** or **git.example.com**). Use this when SSH uses a different hostname than HTTP/API operations. Only affects SSH cloning and Git operations. Also accepted as: **gitlab\_ssh\_host**. Scoped per host; set it with **--host**. Environment variable: **GITLAB\_SSH\_HOST**. - • **subfolder**: Subfolder where GitLab is installed (e.g., **gitlab** for https://example.com/gitlab/). Use this when GitLab is hosted at a subfolder rather than domain root. Supports nested paths (e.g., **apps/gitlab** for https://example.com/apps/gitlab/). Slashes are automatically trimmed, so **gitlab**, **/gitlab**, and **gitlab/** are equivalent. Only applies to HTTP/HTTPS operations (API and Git clone). Also accepted as: **gitlab\_subfolder**. Scoped per host; set it with **--host**. Environment variable: **GITLAB\_SUBFOLDER**. - • **telemetry**: Set to false (0) to disable sending usage data to your GitLab instance or true (1) to enable. See https://docs.gitlab.com/administration/settings/usage\_statistics/ for more information. Environment variable: **GLAB\_SEND\_TELEMETRY**. - • **token**: Your GitLab access token. To get one, read https://docs.gitlab.com/user/profile/personal\_access\_tokens/. A token set through an environment variable is sent only to the host named by **GITLAB\_HOST** (or the **host** configuration key) or **GITLAB\_REPO**, and to hosts already present in your configuration file. A host named only in a command argument receives no token. Also accepted as: **gitlab\_token**, **oauth\_token**. Scoped per host; set it with **--host**. Environment variables, first one set wins: **GITLAB\_TOKEN**, **GITLAB\_ACCESS\_TOKEN**, **OAUTH\_TOKEN**. - • **use\_keyring**: Store the host's credentials in the operating system's keyring (true/false). Set automatically by **glab auth login**, which defaults to **true** when a keyring backend is available. Empty is treated as false (plaintext file storage). Scoped per host; set it with **--host**. Environment variables, first one set wins: **GLAB\_USE\_KEYRING**, **USE\_KEYRING**. Configuration file locations follow the XDG Base Directory specification. For the full search order and platform-specific paths, see configuration ⟨https://docs.gitlab.com/cli/configuration/⟩. ## OPTIONS **-g**, **--global**\[=false\]\ Use global config file. ## OPTIONS INHERITED FROM PARENT COMMANDS **-h**, **--help**\[=false\]\ Show help for this command. ## SEE ALSO **[glab(1)](/glab/1.md)**, **[glab-config-edit(1)](/glab-config-edit/1.md)**, **[glab-config-get(1)](/glab-config-get/1.md)**, **[glab-config-path(1)](/glab-config-path/1.md)**, **[glab-config-set(1)](/glab-config-set/1.md)**