［Linux］GHCR（GitHub Container Registry）にイメージをプッシュ

GHCR（GitHub Container Registry）にイメージをプッシュします。

GitHub でアカウントを作成します。

GHCR へプッシュするには、2025/11/04 時点では、classic のトークンが必要です。
（今後 fine-grained personal access token でもできるようになると思います）

GitHub にアクセスします。

右上のアイコン -> Settings -> 左下の Developser settings -> 左の Personal access tokens -> Tokens (classic) -> 中央の Generate new token -> Generate new token (classic)

Note: Docker
Expiration : 90 days
Select scopes : 「write:package」にチェック

一番下の Generate toke でトークンを作成できます。
作成したら、表示されたトークンを覚えておいてください。

GitHub で リポジトリを作成します。
非公開にしたい場合は、Choose visibility を Private にします。

今回は、my-nginx と言うリポジトリを作成しました。

ログイン

docker login ghcr.io -u {GitHub のユーザ名}

（例）
docker login ghcr.io -u testuser

パスワードは、作成したトークンを入力してください。

ログアウト

docker logout ghcr.io

ログインを自動化する場合は、環境変数やファイルにパスワードを書いて、パスワードが見える状態にしないでください。
パスワードが見える状態のコマンドを実行すると、操作ログからパスワードが漏洩します。

今回は、~/docker_test/token.txt にトークンを書きました。

token.txt に書かれたパスワードを使ってログイン

cat token.txt | docker login ghcr.io -u {GitHub のユーザ名} --password-stdin

（例）
cat token.txt | docker login ghcr.io -u testuser --password-stdin

イメージに GHCR のユーザ名を付けた別名を付けます。

docker tag {リポジトリ名}:{タグ} ghcr.io/{GitHub のユーザ名}/{リポジトリ名}:{タグ}

（例）
docker tag my-nginx:1.0.0 ghcr.io/testuser/my-nginx:1.0.0

GHCR にプッシュします。

docker push ghcr.io/{GitHub のユーザ名}/{リポジトリ名}:{タグ}

（例）
docker push ghcr.io/test_user/my-nginx:1.0.0

成功すると、GitHub の Packages に表示されます。

よくあるエラー
「unauthorized: unauthenticated: User cannot be authenticated with the token provided.」
→ ログインできていません。

「denied: permission_denied: The token provided does not match expected scopes.」
→ スコープが足りていません。GitHub のトークンに「write:package」がチェックされているか確認してください。

GHCR にプッシュしたイメージは、通常のイメージと同様に使用できます。

docker run \
  --name my-nginx-test \
  -d \
  -p 80:80 \
  ghcr.io/testuser/my-nginx:1.0.0