---
name: "glab-auth-configure-docker"
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-auth-configure-docker"
---

# glab-auth-configure-docker(1)

Register glab as a Docker credential helper.

## NAME

glab-auth-configure-docker - Register glab as a Docker credential helper.

## SYNOPSIS

**glab auth configure-docker \[flags\]**

## DESCRIPTION

Configures Docker to use glab for authentication with GitLab container registries. This command runs only on Linux and macOS.

After you run this command, Docker uses glab to obtain credentials when it pulls from or pushes to a GitLab container registry.

Docker looks for the credential helper script by name on your **PATH**. By default, glab installs the script next to the glab binary. If that directory is not writable, glab falls back to **~/.local/bin**, then to any other writable directory on your **PATH**. If the script lands in a directory that is not on your **PATH**, glab tells you which directory to add.

## OPTIONS INHERITED FROM PARENT COMMANDS

**-h**, **--help**\[=false\]\
 	Show help for this command.

## EXAMPLE

```
# Configure Docker to use glab for GitLab container registry authentication
glab auth configure-docker
```

## SEE ALSO

**[glab-auth(1)](/glab-auth/1.md)**