Fixing GitHub Actions push to ghcr '403 Forbidden' error

此文章有中文版本/This article is available in Chinese

Phenomenon

The GitHub Action workflow setup looks like this:

When running it, the following error occurs:

Solution

Everything worked fine during the initial build. However, when I re-cloned the repository and attempted to build it again while preparing a tutorial, I kept encountering a 403 error. After a lengthy search, I finally found the solution.

Original discussion link: Random 403 errors when pushing to GHCR · Issue #463 · docker/build-push-action (github.com)

Adjust Settings on GitHub

Access the following URL:
https://github.com/orgs/[XXX]/packages/container/[YYY]/settings

Replace [XXX] with your GitHub username and [YYY] with the project name.
For instance, after forking the repository, my repo is HowieHz/umami, so I accessed:
https://github.com/orgs/HowieHz/packages/container/umami/settings

Fix the Permissions

Following onedr0p's instructions:

1. Click on Add Repository to include your repository.
2. Set the rule to Write or Admin.

After these changes, the issue should be resolved.

Related Articles

• Fixing Docker Pull Image "ghcr.io..." Unauthorized Error

To make searching easier, this article and the one linked above were extracted from the following article:
Addressing the Umami Active API Latency Issue