.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-config - Manage glab settings.


.SH SYNOPSIS
\fBglab config [flags]\fP


.SH DESCRIPTION
Manage key/value strings.

.PP
Current respected settings:
.IP \(bu 2
\fBapi_host\fR: Configure host for API endpoint. Defaults to the host itself. Also accepted as: \fBgitlab_api_host\fR\&. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBapi_protocol\fR: What protocol to use to access the API endpoint. Supported values: \fBhttp\fR, \fBhttps\fR\&. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBartifact_registry_domains\fR: 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 \fBdocker pull\fR hard-fails. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBbranch_prefix\fR: Prefix used by \fBglab stack\fR when naming generated branches. Defaults to the current user's username (from \fBos/user.Current\fR), falling back to \fBglab-stack\fR if unavailable.
.IP \(bu 2
\fBbrowser\fR: What browser glab should run when opening links. This global config cannot be overridden by hostname.
.IP \(bu 2
\fBca_cert\fR: 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 \fB--host\fR\&.
.IP \(bu 2
\fBcheck_update\fR: Allow glab to automatically check for updates and notify you when there are new updates.
.IP \(bu 2
\fBclient_cert\fR: Path to a client certificate (PEM) used for mutual TLS authentication. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBclient_id\fR: OAuth application client ID. Required when authenticating with OAuth against a self-managed GitLab instance. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBclient_key\fR: Path to the private key (PEM) that matches client_cert. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBcontainer_registry_domains\fR: The domains of associated container registries. These are used to configure the Docker credential helper. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBcustom_headers\fR: 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 \fB--host\fR\&.
.IP \(bu 2
\fBdebug\fR: Output more logging information, including underlying Git commands, expanded aliases, and DNS error details.
.IP \(bu 2
\fBdisplay_hyperlinks\fR: 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.
.IP \(bu 2
\fBduo_cli_auto_download\fR: Automatically download Duo CLI binary without prompting (true/false).
.IP \(bu 2
\fBduo_cli_auto_run\fR: Automatically run GitLab Duo CLI without prompting (true/false). Set to true to skip the confirmation prompt.
.IP \(bu 2
\fBeditor\fR: What editor glab should run when creating issues, merge requests, etc. This global config cannot be overridden by hostname. Also accepted as: \fBvisual\fR, \fBglab_editor\fR\&.
.IP \(bu 2
\fBgit_protocol\fR: What protocol to use when performing Git operations. Supported values: \fBssh\fR, \fBhttps\fR\&.
.IP \(bu 2
\fBglab_pager\fR: Your desired pager command to use, such as \fBless -R\fR\&. Takes precedence over the PAGER environment variable. GLAB_PAGER takes precedence over both.
.IP \(bu 2
\fBglamour_style\fR: Set your desired Markdown renderer style. Available options are [dark, light, notty]. To set a custom style, refer to https://github.com/charmbracelet/glamour#styles.
.IP \(bu 2
\fBhost\fR: Default GitLab hostname to use. Also accepted as: \fBgitlab_host\fR, \fBgitlab_uri\fR, \fBgl_host\fR\&.
.IP \(bu 2
\fBjob_token\fR: 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 \fB--host\fR\&.
.IP \(bu 2
\fBno_prompt\fR: Set to true (1) to disable prompts, or false (0) to enable them. Also accepted as: \fBprompt_disabled\fR\&.
.IP \(bu 2
\fBnotify_skill_updates\fR: Show a notice when an installed agent skill (bundled or remote) has updates available.
.IP \(bu 2
\fBorbit_local_auto_download\fR: Automatically download Orbit local CLI binary without prompting (true/false).
.IP \(bu 2
\fBorbit_local_auto_run\fR: Automatically run Orbit local CLI without prompting (true/false). Set to true to skip the confirmation prompt.
.IP \(bu 2
\fBproxy\fR: Custom proxy for this host. Overrides environment proxy settings when set. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBremote_alias\fR: Name of the \fBgit remote\fR that points at the GitLab repository. Used to resolve which remote to operate against when multiple are configured. Also accepted as: \fBgit_remote_url_var\fR, \fBgit_remote_alias\fR, \fBremote_nickname\fR, \fBgit_remote_nickname\fR\&.
.IP \(bu 2
\fBshow_whats_new\fR: Show a one-time post-upgrade banner pointing at \fBglab whatsnew\fR when a new version is detected.
.IP \(bu 2
\fBskip_tls_verify\fR: 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 \fB--host\fR\&.
.IP \(bu 2
\fBssh_host\fR: Alternate hostname for SSH Git operations (e.g., \fBssh.example.com\fR or \fBgit.example.com\fR). Use this when SSH uses a different hostname than HTTP/API operations. Only affects SSH cloning and Git operations. Also accepted as: \fBgitlab_ssh_host\fR\&. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBsubfolder\fR: Subfolder where GitLab is installed (e.g., \fBgitlab\fR for https://example.com/gitlab/). Use this when GitLab is hosted at a subfolder rather than domain root. Supports nested paths (e.g., \fBapps/gitlab\fR for https://example.com/apps/gitlab/). Slashes are automatically trimmed, so \fBgitlab\fR, \fB/gitlab\fR, and \fBgitlab/\fR are equivalent. Only applies to HTTP/HTTPS operations (API and Git clone). Also accepted as: \fBgitlab_subfolder\fR\&. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBtelemetry\fR: 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.
.IP \(bu 2
\fBtoken\fR: Your GitLab access token. To get one, read https://docs.gitlab.com/user/profile/personal_access_tokens/. Also accepted as: \fBgitlab_token\fR, \fBoauth_token\fR\&. Scoped per host; set it with \fB--host\fR\&.
.IP \(bu 2
\fBuse_keyring\fR: Store the host's credentials in the operating system's keyring (true/false). Set automatically by \fBglab auth login\fR, which defaults to \fBtrue\fR when a keyring backend is available. Empty is treated as false (plaintext file storage). Scoped per host; set it with \fB--host\fR\&.

.PP
Configuration file locations follow the XDG Base Directory specification.
For the full search order and platform-specific paths, see configuration
\[la]https://gitlab.com/gitlab\-org/cli#configuration\[ra]\&.


.SH OPTIONS
\fB-g\fP, \fB--global\fP[=false]
	Use global config file.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.


.SH SEE ALSO
\fBglab(1)\fP, \fBglab-config-edit(1)\fP, \fBglab-config-get(1)\fP, \fBglab-config-path(1)\fP, \fBglab-config-set(1)\fP