silverwind and bircni
c00af83676
Document the artifact retention limit ( #602 )
...
Documents https://github.com/go-gitea/gitea/pull/39894 for main and 28. Workflows can request a shorter artifact retention, down to 1 day, and `github.retention_days` carries `ARTIFACT_RETENTION_DAYS`, empty when artifacts are kept forever.
---------
Co-authored-by: bircni <[email protected] >
Reviewed-on: https://gitea.com/gitea/docs/pulls/602
Reviewed-by: bircni <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-10-22 20:05:39 +00:00
silverwind
c9282b96da
Clarify reverse proxy authentication requirements ( #604 )
...
Document that reverse proxy authentication requires Gitea to be reachable only through the authenticating proxy, and which routes each setting covers. Companion to https://github.com/go-gitea/gitea/pull/39940 .
_Written by Claude._
Reviewed-on: https://gitea.com/gitea/docs/pulls/604
Reviewed-by: bircni <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-10-22 16:33:31 +00:00
silverwind
424c481e19
docs: drop the gc.reflogExpire default ( #584 )
...
Gitea no longer sets `gc.reflogExpire`, leaving reflog expiry to git's defaults, see https://github.com/go-gitea/gitea/pull/39703 , backported in https://github.com/go-gitea/gitea/pull/39711 .
Reviewed-on: https://gitea.com/gitea/docs/pulls/584
Reviewed-by: Lunny Xiao <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-10-10 16:56:06 +00:00
silverwind
ad95b7776c
docs: update GO_GET_CLONE_URL_PROTOCOL default ( #580 )
...
Copy the new `app.example.ini` wording from https://github.com/go-gitea/gitea/pull/39674 , backported in https://github.com/go-gitea/gitea/pull/39676 . `GO_GET_CLONE_URL_PROTOCOL` now defaults to ssh when `DISABLE_HTTP_GIT` is enabled.
Reviewed-on: https://gitea.com/gitea/docs/pulls/580
Reviewed-by: wxiaoguang <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-10-08 13:28:26 +00:00
silverwind
7219c0e44d
docs: fix the REPOSITORY_AVATAR_FALLBACK_IMAGE default ( #569 )
...
The cheat sheet lists `/img/repo_default.png` as the `REPOSITORY_AVATAR_FALLBACK_IMAGE` default, but public files moved under `/assets` in Gitea 1.15 (https://github.com/go-gitea/gitea/pull/15219 ), so that path 404s. Like `app.example.ini` in https://github.com/go-gitea/gitea/pull/39514 , document the default as empty, falling back to Gitea's builtin repository avatar, and note that a custom value is used as-is without the sub-path. Applies to all documented versions and translations.
_Written by Claude Code (Opus 5.5)._
Reviewed-on: https://gitea.com/gitea/docs/pulls/569
Reviewed-by: wxiaoguang <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-10-01 08:28:50 +00:00
silverwind
4a0ef0480b
docs: update the SSH_SERVER_HOST_KEYS default and generated keys ( #566 )
...
Since https://github.com/go-gitea/gitea/pull/33974 (1.27), `SSH_SERVER_HOST_KEYS` defaults to `ssh/gitea.rsa, ssh/gitea.ed25519, ssh/gitea.ecdsa, ssh/gogs.rsa`. When none of the keys exist, Gitea generates 4096 bit RSA, 256 bit ECDSA and ED25519 keys instead of RSA alone. This updates next, 28 and 1.27 in all three languages, matching https://github.com/go-gitea/gitea/pull/39500 .
Written by Claude.
Reviewed-on: https://gitea.com/gitea/docs/pulls/566
Reviewed-by: Lunny Xiao <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-09-30 23:34:35 +00:00
bircni and silverwind
7d9a82df8d
add artifact preview ( #533 )
...
Document Actions artifact previews added in https://github.com/go-gitea/gitea/pull/36754 , including supported content, authentication and sandboxing behavior, navigation, and size limits.
Also document the `ARTIFACT_PREVIEW_MAX_SIZE` configuration option so administrators can limit or disable previews.
Co-authored-by: silverwind <[email protected] >
Reviewed-on: https://gitea.com/gitea/docs/pulls/533
Reviewed-by: Lunny Xiao <[email protected] >
Reviewed-by: silverwind <[email protected] >
Co-authored-by: bircni <[email protected] >
2026-09-30 11:43:03 +00:00
6934d56056
docs: document egress modes and host lists ( #557 )
...
Documents the settings changed by https://github.com/go-gitea/gitea/pull/39426 : `EGRESS_MODE`, the `[migrations]` `ALLOWED_HOST_LIST`/`BLOCKED_HOST_LIST` replacing `ALLOWED_DOMAINS`, `BLOCKED_DOMAINS` and `ALLOW_LOCALNETWORKS`, and the host list syntax with ports, CGNAT and reserved addresses. Also fixes the `socks://` examples, Go only speaks `socks5://`.
_Written by Claude._
---------
Co-authored-by: Lunny Xiao <[email protected] >
Co-authored-by: TheFox0x7 <[email protected] >
Reviewed-on: https://gitea.com/gitea/docs/pulls/557
Reviewed-by: Lunny Xiao <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-09-30 11:42:29 +00:00
silverwind
c3d9115328
docs: update defaults changed by the install page refactor ( #565 )
...
https://github.com/go-gitea/gitea/pull/39400 made registration disabled by default, switched the session provider default to `file`, and derives `SSH_DOMAIN` and `NO_REPLY_ADDRESS` from `ROOT_URL` now that `[server] DOMAIN` is gone. Updates the next and v28 cheat sheets with the wording from `app.example.ini` in https://github.com/go-gitea/gitea/pull/39456 .
Reviewed-on: https://gitea.com/gitea/docs/pulls/565
Reviewed-by: wxiaoguang <[email protected] >
Co-authored-by: silverwind <[email protected] >
2026-09-30 11:30:26 +00:00
Lunny Xiao
ba60edbbda
Add version v28 ( #564 )
...
<!-- cloudflare-preview --> Preview: https://pr-564.docs-gitea-com.pages.dev
Reviewed-on: https://gitea.com/gitea/docs/pulls/564
Reviewed-by: bircni <[email protected] >
Co-authored-by: Lunny Xiao <[email protected] >
2026-09-30 06:40:44 +00:00