glab(1)

📦
version 1.128.0 · 12 versions
, in arch rolling

💅 glab(1) — glab config, bestie edition 💅

Hey bestie, welcome to the glab(1) page where we talk about glab config. It’s giving settings glow-up, and honestly? main character energy.

🌸 NAME 🌸

glab-config — manages your glab settings, periodt.

✨ SYNOPSIS ✨

glab config [flags]

🎀 DESCRIPTION 🎀

Okay so this command manages key/value strings. That’s the whole vibe. Here are the current respected settings, and yes, every single one is invited to the group chat:

  • api_host — configures the host for the API endpoint. Defaults to the host itself. Also accepted as gitlab_api_host. Scoped per host, so set it with --host. Environment variable: GITLAB_API_HOST.
  • api_protocol — tells glab 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. glab dependency-firewall commands also trust it for package registries and outbound proxies. 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 — lets glab 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 — sets 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 — outputs 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 downloads the 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 runs 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 — sets 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 — shows a notice when an installed agent skill (bundled or remote) has updates available. Environment variable: GLAB_NOTIFY_SKILL_UPDATES.
  • orbit_cli_auto_download — automatically downloads 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 runs 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 — shows 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 — skips 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 — stores 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 the configuration page at https://docs.gitlab.com/cli/configuration/.

💅 OPTIONS 💅

  • -g, --global[=false] — use the global config file, bestie.

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

  • -h, --help[=false] — show help for this command. Iconic.

🦋 SEE ALSO 🦋

Okay that’s the whole page. This manual is auto generated by spf13/cobra, dated Nov 2026, and it’s the glab(1) manual. Bye bestie 💖

📦 where this page comes from