From c5fdf2eb18a44b3d2d9c4fefaaed2e31b5633521 Mon Sep 17 00:00:00 2001 From: Lunny Xiao Date: Sun, 20 Sep 2026 16:46:22 +0000 Subject: [PATCH] docs: use the maintained main-nightly docker tags (#550) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes https://github.com/go-gitea/gitea/issues/39310 The docker install pages tell readers to use `:nightly` / `:nightless-rootless` for the latest development version, but those tags are no longer published — the registry only carries `main-nightly` and `main-nightly-rootless` (plus the per-release-branch `1.x-nightly` tags): ``` $ curl -s https://docker.gitea.com/v2/gitea/tags/list?n=1000 | tr ',' '\n' | grep -E '"(main-)?nightly(-rootless)?"' "main-nightly" "main-nightly-rootless" ``` Anyone who followed the rootless page has been pinned to an image that has not been rebuilt since 2025-08-23. Changes: - point the docker and rootless docker install pages at `:main-nightly` / `:main-nightly-rootless`, in English and in the zh-cn/zh-tw translations - use `1.27-nightly` instead of the long gone `1.16-nightly` as the release branch example (the oldest one still published is `1.19-nightly`) - fix the zh-cn/zh-tw claim that `:latest` installs a development version, and mention the nightly tags there the way the English page does - render `@dockerVersion@` as `main-nightly` for the next version, so the compose snippets on the unreleased docs no longer reference `gitea:nightly` Not touched: the 1.22–1.26 versioned docs carry the same stale tag, but those versions are already out of maintenance — happy to include them if preferred. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Preview: https://pr-550.docs-gitea-com.pages.dev --------- Co-authored-by: bircni Reviewed-on: https://gitea.com/gitea/docs/pulls/550 Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com> Co-authored-by: Lunny Xiao --- docs/installation/with-docker-rootless.md | 2 +- docs/installation/with-docker.md | 2 +- .../current/installation/with-docker-rootless.md | 2 +- .../current/installation/with-docker.md | 2 +- .../version-1.27/installation/with-docker-rootless.md | 2 +- .../version-1.27/installation/with-docker.md | 2 +- .../current/installation/with-docker-rootless.md | 2 +- .../current/installation/with-docker.md | 2 +- .../version-1.27/installation/with-docker-rootless.md | 2 +- .../version-1.27/installation/with-docker.md | 2 +- packages/content-loader/src/products.ts | 2 +- .../version-1.27/installation/with-docker-rootless.md | 2 +- versioned_docs/version-1.27/installation/with-docker.md | 2 +- 13 files changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/installation/with-docker-rootless.md b/docs/installation/with-docker-rootless.md index d2bfc0e6..2d5e7a03 100644 --- a/docs/installation/with-docker-rootless.md +++ b/docs/installation/with-docker-rootless.md @@ -66,7 +66,7 @@ server-1 | 2026-03-11T12:57:50.796198843Z /var/lib/gitea/git is not writable server-1 | 2026-03-11T12:57:50.796235667Z docker setup failed ``` -For a stable release you could use `:latest-rootless`, `:1-rootless` or specify a certain release like `:@dockerVersion@-rootless`, but if you'd like to use the latest development version then `:nightly-rootless` would be an appropriate tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly-rootless` tag, where x is the minor version of Gitea. (e.g. `:1.16-nightly-rootless`) +For a stable release you could use `:latest-rootless`, `:1-rootless` or specify a certain release like `:@dockerVersion@-rootless`, but if you'd like to use the latest development version then `:main-nightly-rootless` would be an appropriate tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly-rootless` tag, where x is the minor version of Gitea. (e.g. `:1.27-nightly-rootless`) ## Named volumes diff --git a/docs/installation/with-docker.md b/docs/installation/with-docker.md index c3cf946c..895e6797 100644 --- a/docs/installation/with-docker.md +++ b/docs/installation/with-docker.md @@ -30,7 +30,7 @@ image as a service. Since there is no database available, one can be initialized Create a directory like `gitea` and paste the following content into a file named `docker-compose.yml`. Note that the volume should be owned by the user/group with the UID/GID specified in the config file. If you don't give the volume correct permissions, the container may not start. -For a stable release you can use `:latest`, `:1` or specify a certain release like `:@dockerVersion@`, but if you'd like to use the latest development version of Gitea then you could use the `:nightly` tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly` tag, where x is the minor version of Gitea. (e.g. `:1.16-nightly`) +For a stable release you can use `:latest`, `:1` or specify a certain release like `:@dockerVersion@`, but if you'd like to use the latest development version of Gitea then you could use the `:main-nightly` tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly` tag, where x is the minor version of Gitea. (e.g. `:1.27-nightly`) ```yaml networks: diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md index be04d7e4..0823127d 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md @@ -53,7 +53,7 @@ sudo chown 1000:1000 config/ data/ > 如果未为卷设置正确的权限，容器可能无法启动。 -对于稳定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的开发版本，则可以使用 `:dev-rootless` 标签。如果您想运行发布分支的最新提交，可以使用 `:1.x-dev-rootless` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.16-dev-rootless`）。 +对于稳定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的开发版本，则可以使用 `:main-nightly-rootless` 标签。如果您想运行发布分支的最新提交，可以使用 `:1.x-nightly-rootless` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.27-nightly-rootless`）。 ## 自定义端口 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker.md b/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker.md index 06bdc285..812d73cb 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/current/installation/with-docker.md @@ -14,7 +14,7 @@ Gitea 在其 Docker Hub 组织内提供自动更新的 Docker 镜像。可以始 ## 基本 -最简单的设置只是创建一个卷和一个网络，然后将 `docker.gitea.com/gitea:latest` 镜像作为服务启动。由于没有可用的数据库，因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录，并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意，该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限，则容器可能无法启动。另请注意，标签 `:latest` 将安装当前的开发版本。对于稳定的发行版，您可以使用 `:1` 或指定某个发行版，例如 `@dockerVersion@`。 +最简单的设置只是创建一个卷和一个网络，然后将 `docker.gitea.com/gitea:latest` 镜像作为服务启动。由于没有可用的数据库，因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录，并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意，该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限，则容器可能无法启动。另请注意，标签 `:latest` 安装的是最新的稳定版本。对于稳定的发行版，您也可以使用 `:1` 或指定某个发行版，例如 `@dockerVersion@`。如果您想使用最新的开发版本，则可以使用 `:main-nightly` 标签；如果您想运行发布分支的最新提交，可以使用 `:1.x-nightly` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.27-nightly`）。 ```yaml version: "3" diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md index be04d7e4..0823127d 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md @@ -53,7 +53,7 @@ sudo chown 1000:1000 config/ data/ > 如果未为卷设置正确的权限，容器可能无法启动。 -对于稳定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的开发版本，则可以使用 `:dev-rootless` 标签。如果您想运行发布分支的最新提交，可以使用 `:1.x-dev-rootless` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.16-dev-rootless`）。 +对于稳定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的开发版本，则可以使用 `:main-nightly-rootless` 标签。如果您想运行发布分支的最新提交，可以使用 `:1.x-nightly-rootless` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.27-nightly-rootless`）。 ## 自定义端口 diff --git a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md index 06bdc285..812d73cb 100644 --- a/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md +++ b/i18n/zh-cn/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md @@ -14,7 +14,7 @@ Gitea 在其 Docker Hub 组织内提供自动更新的 Docker 镜像。可以始 ## 基本 -最简单的设置只是创建一个卷和一个网络，然后将 `docker.gitea.com/gitea:latest` 镜像作为服务启动。由于没有可用的数据库，因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录，并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意，该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限，则容器可能无法启动。另请注意，标签 `:latest` 将安装当前的开发版本。对于稳定的发行版，您可以使用 `:1` 或指定某个发行版，例如 `@dockerVersion@`。 +最简单的设置只是创建一个卷和一个网络，然后将 `docker.gitea.com/gitea:latest` 镜像作为服务启动。由于没有可用的数据库，因此可以使用 SQLite3 初始化数据库。创建一个类似 `gitea` 的目录，并将以下内容粘贴到名为 `docker-compose.yml` 的文件中。请注意，该卷应由配置文件中指定的 UID/GID 的用户/组拥有。如果您不授予卷正确的权限，则容器可能无法启动。另请注意，标签 `:latest` 安装的是最新的稳定版本。对于稳定的发行版，您也可以使用 `:1` 或指定某个发行版，例如 `@dockerVersion@`。如果您想使用最新的开发版本，则可以使用 `:main-nightly` 标签；如果您想运行发布分支的最新提交，可以使用 `:1.x-nightly` 标签，其中 x 是 Gitea 的次要版本号（例如:`1.27-nightly`）。 ```yaml version: "3" diff --git a/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md b/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md index 42f7e9c3..15a99fa6 100644 --- a/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md +++ b/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker-rootless.md @@ -53,7 +53,7 @@ sudo chown 1000:1000 config/ data/ > 如果未為卷設定正確的權限，容器可能無法啟動。 -對於穩定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的開發版本，則可以使用 `:dev-rootless` 標籤。如果您想運行發佈分支的最新提交，可以使用 `:1.x-dev-rootless` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.16-dev-rootless`）。 +對於穩定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的開發版本，則可以使用 `:main-nightly-rootless` 標籤。如果您想運行發佈分支的最新提交，可以使用 `:1.x-nightly-rootless` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.27-nightly-rootless`）。 ## 自訂端口 diff --git a/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker.md b/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker.md index 189a7840..2faec3bf 100644 --- a/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker.md +++ b/i18n/zh-tw/docusaurus-plugin-content-docs/current/installation/with-docker.md @@ -14,7 +14,7 @@ Gitea 在其 Docker Hub 組織內提供自動更新的 Docker 鏡像。可以始 ## 基本 -最簡單的設定只是建立一個卷和一個網路，然後將 `docker.gitea.com/gitea:latest` 鏡像作為服務啟動。由於沒有可用的資料庫，因此可以使用 SQLite3 初始化資料庫。建立一個類似 `gitea` 的目錄，並將以下內容粘貼到名為 `docker-compose.yml` 的文件中。請注意，該卷應由設定文件中指定的 UID/GID 的使用者/組擁有。如果您不授予卷正確的權限，則容器可能無法啟動。另請注意，標籤 `:latest` 將安裝當前的開發版本。對於穩定的發行版，您可以使用 `:1` 或指定某個發行版，例如 `@dockerVersion@`。 +最簡單的設定只是建立一個卷和一個網路，然後將 `docker.gitea.com/gitea:latest` 鏡像作為服務啟動。由於沒有可用的資料庫，因此可以使用 SQLite3 初始化資料庫。建立一個類似 `gitea` 的目錄，並將以下內容粘貼到名為 `docker-compose.yml` 的文件中。請注意，該卷應由設定文件中指定的 UID/GID 的使用者/組擁有。如果您不授予卷正確的權限，則容器可能無法啟動。另請注意，標籤 `:latest` 安裝的是最新的穩定版本。對於穩定的發行版，您也可以使用 `:1` 或指定某個發行版，例如 `@dockerVersion@`。如果您想使用最新的開發版本，則可以使用 `:main-nightly` 標籤；如果您想運行發佈分支的最新提交，可以使用 `:1.x-nightly` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.27-nightly`）。 ```yaml version: "3" diff --git a/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md b/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md index 42f7e9c3..15a99fa6 100644 --- a/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md +++ b/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker-rootless.md @@ -53,7 +53,7 @@ sudo chown 1000:1000 config/ data/ > 如果未為卷設定正確的權限，容器可能無法啟動。 -對於穩定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的開發版本，則可以使用 `:dev-rootless` 標籤。如果您想運行發佈分支的最新提交，可以使用 `:1.x-dev-rootless` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.16-dev-rootless`）。 +對於穩定版本，您可以使用 `:latest-rootless`、`:1-rootless`，或指定特定的版本，如: `@dockerVersion@-rootless`。如果您想使用最新的開發版本，則可以使用 `:main-nightly-rootless` 標籤。如果您想運行發佈分支的最新提交，可以使用 `:1.x-nightly-rootless` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.27-nightly-rootless`）。 ## 自訂端口 diff --git a/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md b/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md index 189a7840..2faec3bf 100644 --- a/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md +++ b/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.27/installation/with-docker.md @@ -14,7 +14,7 @@ Gitea 在其 Docker Hub 組織內提供自動更新的 Docker 鏡像。可以始 ## 基本 -最簡單的設定只是建立一個卷和一個網路，然後將 `docker.gitea.com/gitea:latest` 鏡像作為服務啟動。由於沒有可用的資料庫，因此可以使用 SQLite3 初始化資料庫。建立一個類似 `gitea` 的目錄，並將以下內容粘貼到名為 `docker-compose.yml` 的文件中。請注意，該卷應由設定文件中指定的 UID/GID 的使用者/組擁有。如果您不授予卷正確的權限，則容器可能無法啟動。另請注意，標籤 `:latest` 將安裝當前的開發版本。對於穩定的發行版，您可以使用 `:1` 或指定某個發行版，例如 `@dockerVersion@`。 +最簡單的設定只是建立一個卷和一個網路，然後將 `docker.gitea.com/gitea:latest` 鏡像作為服務啟動。由於沒有可用的資料庫，因此可以使用 SQLite3 初始化資料庫。建立一個類似 `gitea` 的目錄，並將以下內容粘貼到名為 `docker-compose.yml` 的文件中。請注意，該卷應由設定文件中指定的 UID/GID 的使用者/組擁有。如果您不授予卷正確的權限，則容器可能無法啟動。另請注意，標籤 `:latest` 安裝的是最新的穩定版本。對於穩定的發行版，您也可以使用 `:1` 或指定某個發行版，例如 `@dockerVersion@`。如果您想使用最新的開發版本，則可以使用 `:main-nightly` 標籤；如果您想運行發佈分支的最新提交，可以使用 `:1.x-nightly` 標籤，其中 x 是 Gitea 的次要版本號（例如:`1.27-nightly`）。 ```yaml version: "3" diff --git a/packages/content-loader/src/products.ts b/packages/content-loader/src/products.ts index d283bde8..c6fa1922 100644 --- a/packages/content-loader/src/products.ts +++ b/packages/content-loader/src/products.ts @@ -82,7 +82,7 @@ const variables: Record = { version: 'main-nightly', sourceVersion: 'main', sourceBranch: 'main', - dockerVersion: 'nightly', + dockerVersion: 'main-nightly', displayVersion: '1.28-dev', }, '1.27': { diff --git a/versioned_docs/version-1.27/installation/with-docker-rootless.md b/versioned_docs/version-1.27/installation/with-docker-rootless.md index d2bfc0e6..2d5e7a03 100644 --- a/versioned_docs/version-1.27/installation/with-docker-rootless.md +++ b/versioned_docs/version-1.27/installation/with-docker-rootless.md @@ -66,7 +66,7 @@ server-1 | 2026-03-11T12:57:50.796198843Z /var/lib/gitea/git is not writable server-1 | 2026-03-11T12:57:50.796235667Z docker setup failed ``` -For a stable release you could use `:latest-rootless`, `:1-rootless` or specify a certain release like `:@dockerVersion@-rootless`, but if you'd like to use the latest development version then `:nightly-rootless` would be an appropriate tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly-rootless` tag, where x is the minor version of Gitea. (e.g. `:1.16-nightly-rootless`) +For a stable release you could use `:latest-rootless`, `:1-rootless` or specify a certain release like `:@dockerVersion@-rootless`, but if you'd like to use the latest development version then `:main-nightly-rootless` would be an appropriate tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly-rootless` tag, where x is the minor version of Gitea. (e.g. `:1.27-nightly-rootless`) ## Named volumes diff --git a/versioned_docs/version-1.27/installation/with-docker.md b/versioned_docs/version-1.27/installation/with-docker.md index 3bf86067..46ac850f 100644 --- a/versioned_docs/version-1.27/installation/with-docker.md +++ b/versioned_docs/version-1.27/installation/with-docker.md @@ -30,7 +30,7 @@ image as a service. Since there is no database available, one can be initialized Create a directory like `gitea` and paste the following content into a file named `docker-compose.yml`. Note that the volume should be owned by the user/group with the UID/GID specified in the config file. If you don't give the volume correct permissions, the container may not start. -For a stable release you can use `:latest`, `:1` or specify a certain release like `:@dockerVersion@`, but if you'd like to use the latest development version of Gitea then you could use the `:nightly` tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly` tag, where x is the minor version of Gitea. (e.g. `:1.16-nightly`) +For a stable release you can use `:latest`, `:1` or specify a certain release like `:@dockerVersion@`, but if you'd like to use the latest development version of Gitea then you could use the `:main-nightly` tag. If you'd like to run the latest commit from a release branch you can use the `:1.x-nightly` tag, where x is the minor version of Gitea. (e.g. `:1.27-nightly`) ```yaml networks: