できない.dev

docker login の認証情報が保存できない(毎回ログインを求められる)

~/.docker/config.json の credsStore が OS のキーチェーンに対応していないと認証情報が保存されない。
OS ごとの credential helper をインストールし、credsStore を明示する。

公開: 更新:

症状できない · exit 1
docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
Error saving credentials: error storing credentials - err: exec: "docker-credential-osxkeychain": executable file not found in $PATH, out: ``
解決後できた · exit 0
docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
WARNING! Your password will be stored unencrypted in /root/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credentials-store

Login Succeeded

2026-10-20 に local host (Windows 11 Home, Docker 29.8.0)(Docker 29.8.0 / Node.js 22.14.0) で実際に打って取った出力。検証環境の詳細

要約

docker login の認証情報は ~/.docker/config.json の credsStore で指定された credential helper(OS キーチェーン)に格納される。
credsStore が指す helper がインストールされていないと、docker login 自体が Error saving credentials: error storing credentials で失敗し、認証情報は保存されない。
credsStore を書かず既定の helper も無い場合は、平文で保存する警告を出したうえで config.json の auths に base64 で保存される。
OS に合った helper をインストールして config.json に credsStore を明示すれば解消する。

実行例

Docker 29.8.0 で上記の手順を動かすと、credsStore が osxkeychain のまま helper が入っていない環境では、docker login が Error saving credentials を出して終了コード 1 で止まった。
credsStore を書かないと、平文で保存する警告とともに auths へ base64 で保存された。
credsStore に pass を指定した場合も credHelpers で指定した場合も、auths のエントリは空のまま Login Succeeded になった。

$ cat ~/.docker/config.json
{"credsStore": "osxkeychain"}
$ docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
Error saving credentials: error storing credentials - err: exec: "docker-credential-osxkeychain": executable file not found in $PATH, out: ``
$ echo $?
1
$ docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
WARNING! Your password will be stored unencrypted in /root/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credentials-store
 
Login Succeeded
$ echo $?
0
$ cat ~/.docker/config.json
{
	"auths": {
		"localhost:55001": {
			"auth": "ZGVtbzpkZW1vLXBhc3M="
		}
	}
}
$ docker logout localhost:55001
Removing login credentials for localhost:55001
$ which docker-credential-pass
/usr/bin/docker-credential-pass
$ cat ~/.docker/config.json
{"credsStore": "pass"}
$ docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
Login Succeeded
$ echo $?
0
$ cat ~/.docker/config.json
{
	"auths": {
		"localhost:55001": {}
	},
	"credsStore": "pass"
}
$ docker logout localhost:55001
Removing login credentials for localhost:55001
$ cat ~/.docker/config.json
{"credHelpers": {"localhost:55001": "pass"}}
$ docker login localhost:55001 -u demo --password-stdin <<<"$REGISTRY_PASSWORD"
Login Succeeded
$ echo $?
0
$ cat ~/.docker/config.json
{
	"auths": {
		"localhost:55001": {}
	},
	"credHelpers": {
		"localhost:55001": "pass"
	}
}

— 2026-10-20 時点の出力

検証環境Node.js 22.14.0 / npm 10.9.2 / Git 2.48.1.windows.1 / 2026-10-20 検証(ほか 1 件)
検証日
実行環境
local host (Windows 11 Home, Docker 29.8.0)
バージョン
  • Node.js 22.14.0
  • npm 10.9.2
  • Git 2.48.1.windows.1
  • Docker 29.8.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. credential helper をインストール

OS ごとのインストール例を示す。

# macOS(Docker Desktop に同梱)
which docker-credential-osxkeychain
# 無い場合は brew で導入
# brew install docker-credential-helper
 
# Linux: docker-credential-helpers の Release から取得
curl -L https://github.com/docker/docker-credential-helpers/releases/download/v0.9.10/docker-credential-secretservice-v0.9.10.linux-amd64 \
  -o /usr/local/bin/docker-credential-secretservice
chmod +x /usr/local/bin/docker-credential-secretservice

リポジトリと対応 OS の一覧は docker/docker-credential-helpers(新しいタブで開く) にある。

2. config.json で credsStore を指定

{
  "credsStore": "osxkeychain"
}

複数のレジストリで helper を分けるなら credHelpers を使う。

{
  "credHelpers": {
    "ghcr.io": "osxkeychain",
    "registry.example.com": "pass"
  }
}

CLI 仕様と保存先の挙動は docker login | Docker Docs(新しいタブで開く) に詳述されている。

3. ログインし直す

docker logout
docker login ghcr.io -u USERNAME --password-stdin <<<"$GITHUB_TOKEN"

ログイン後、~/.docker/config.json の auths にはレジストリ名だけが auth キーの無い空のエントリで残る(helper に格納された証拠)。
そのうえで docker pull が認証エラー無く通れば、設定は成功している。

4. ユーザーごとの config.json を揃える

sudo で叩くと /root/.docker/config.json に保存されるため、通常ユーザーの実行で再認証が要る。
docker グループにユーザーを追加するか、rootless Docker を使い、常に同じユーザーで実行する。
CI でも実行ユーザーを揃え、$DOCKER_CONFIG 環境変数で config ディレクトリを明示すると、さらに安全になる。

よくある原因

  1. ~/.docker/config.json の credsStore キーが無く既定の helper も見つからないため、認証情報が helper ではなく auths に base64 の平文で保存されている。
  2. macOS で Docker Desktop を使っていないのに、docker-credential-osxkeychain が PATH に無い。
  3. Linux で docker-credential-secretservice や docker-credential-pass がインストールされていない。
  4. sudo docker login で root の /root/.docker/config.json に保存され、通常ユーザーから参照されない。
  5. Docker Desktop のサインアウト後に、config.json が再初期化されている。