a6b87cb424
docs: WebSocket requirements for reverse proxies ( #463 )
...
Documents the WebSocket endpoint `/-/ws` added in https://github.com/go-gitea/gitea/pull/36965 and fixes the examples that could not serve it.
1. Nginx: adds the missing `proxy_http_version 1.1`, without it Nginx talks HTTP/1.0 upstream and Gitea rejects the handshake.
1. Apache HTTPD: `upgrade=websocket` on the existing `ProxyPass` rule, handled by `mod_proxy_http` since 2.4.48.
1. Nginx Proxy Manager: use the `Websockets Support` toggle, a duplicate `proxy_http_version` stops Nginx from starting.
1. IIS: the `WebSocket Protocol` Windows feature is required.
---------
Co-authored-by: silverwind <[email protected] [email protected] [email protected] https://gitea.com/gitea/docs/pulls/463
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-07-31 13:48:57 +00:00
7b8a06864f
Add documentation for code owner branch protection ( #245 )
...
Documentation for https://github.com/go-gitea/gitea/pull/34995
---------
Co-authored-by: bircni <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/245
Reviewed-by: bircni <[email protected] [email protected]
2026-07-31 12:50:43 +00:00
TheFox0x7 and Lunny Xiao
74674a6259
backport v27 changes ( #471 )
...
See https://github.com/go-gitea/gitea/issues/38621
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/471
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-26 05:20:08 +00:00
wxiaoguang
199e9a2284
repo template supports "exclude" ( #470 )
...
https://github.com/go-gitea/gitea/pull/38064
2026-07-24 16:31:45 +00:00
5581d6d273
Document shared [redis] section (config cheat sheet) ( #468 )
...
Documents the shared `[redis]` section added in https://github.com/go-gitea/gitea/pull/38550 : a single `CONN_STR` that redis-backed subsystems (`[cache]`, `[session]`, `[queue]`, `[global_lock]`) fall back to when their own connection string is empty, with per-subsystem values always taking precedence.
Adds the new section plus one fallback note in the existing Queue/Cache/Session entries.
Note for maintainers: best merged together with (or after) [go-gitea/gitea#38550 ](https://github.com/go-gitea/gitea/pull/38550 ).
---------
Co-authored-by: silverwind <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/468
Reviewed-by: silverwind <[email protected] [email protected]
2026-07-24 08:15:18 +00:00
SudhanshuSingh
53596559be
docs: update runs-on expression support in comparison guide ( #462 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/462
Reviewed-by: wxiaoguang <[email protected] [email protected]
2026-07-12 11:27:00 +00:00
TheFox0x7
985e2239ef
update cheatsheet ( #461 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/461
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-10 20:04:19 +00:00
e3317cd869
Move Hacking to Gitea main repo ( #429 )
...
Related: https://github.com/go-gitea/gitea/pull/37960
Co-authored-by: Lunny Xiao <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/429
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-07-09 23:55:17 +00:00
20c924ddb6
docs: add note on environment variable formatting in case of special characters ( #425 )
...
Added information to explain to the user what to do when sections contain special characters such as `.` and `-`
---------
Co-authored-by: Lunny Xiao <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/425
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-09 23:51:10 +00:00
bircni and Lunny Xiao
938700805b
docs: clarify that [git.config] options override Gitea's built-in defaults ( #444 )
...
User-provided git config options are now applied after Gitea's built-in
defaults, so they take precedence. Update the config cheat sheet to
reflect this new behavior and add a warning about potentially breaking
git operations.
refers to https://github.com/go-gitea/gitea/pull/38172
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/444
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-09 23:50:21 +00:00
965c269495
Update zh tw languages and fix some broken links ( #455 )
...
---------
Co-authored-by: silverwind <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/455
Reviewed-by: silverwind <[email protected]
2026-07-09 23:41:46 +00:00
wxiaoguang
7fa4bc6bd4
update config: DEFAULT_TITLE_SOURCE=branch-name ( #457 )
...
https://github.com/go-gitea/gitea/pull/38356Reviewed-on : https://gitea.com/gitea/docs/pulls/457
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-07 18:40:24 +00:00
TheFox0x7 and Lunny Xiao
9558006c39
update binary verification section ( #449 )
...
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/449
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-01 17:22:39 +00:00
Nicolas
7aae398e37
docs: Update as we now support continue-on-error in 1.27 ( #452 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/452
Reviewed-by: Lunny Xiao <[email protected] [email protected]
2026-07-01 03:20:59 +00:00
Zettat123 and Lunny Xiao
1fb481c186
docs: add docs for scoped workflows ( #447 )
...
Related: https://github.com/go-gitea/gitea/pull/38154
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/447
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-06-28 09:32:51 +00:00
Nicolas and Lunny Xiao
eb65e671a2
Runner docs v1.0.8 ( #435 )
...
Adds a versioned docs snapshot for Gitea Runner v1.0.8 (latest stable),
updates lastVersion and navbar to point to the new version while keeping
0.2.11 in the dropdown for historical reference.
---------
Co-authored-by: Lunny Xiao <[email protected] https://gitea.com/gitea/docs/pulls/435
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-06-14 00:30:30 +00:00
Nicolas
98c4aa4bd0
fix: correct typo in FAQ regarding Configuration Summary ( #436 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/436
Reviewed-by: TheFox0x7 <[email protected] [email protected] [email protected]
2026-06-13 17:07:13 +00:00
wxiaoguang
88f92b0698
Add CONTENT_SECURITY_POLICY_GENERAL ( #434 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/434
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-06-12 01:27:20 +00:00
nico-i
eb5204f658
Added project config to issue template example ( #428 )
...
I have updated the docs since this feature is now supported.
Reviewed-on: https://gitea.com/gitea/docs/pulls/428
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-05-29 16:52:56 +00:00
Zettat123
95106c08e9
docs: split MAX_CREATION_LIMIT into USER_MAX_CREATION_LIMIT and ORG_MAX_CREATION_LIMIT ( #427 )
...
Related https://github.com/go-gitea/gitea/pull/37872
Reviewed-on: https://gitea.com/gitea/docs/pulls/427
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-05-28 17:29:35 +00:00
wxiaoguang
478059a7ed
Update SSH_PORT comment
2026-05-27 06:01:42 +00:00
harryzcy and Chongyi Zheng
69e92d33ec
docs: update conan login command for conan v2 ( #426 )
...
Conan v1 reached end-of-life. https://blog.conan.io/2024/09/30/Conan-Center-will-stop-receiving-updates-for-Conan-1.html
The command for conan v2 login has changed to `conan remote login`. https://docs.conan.io/2/reference/commands/remote.html#conan-remote-login
I briefly looked at Gitea codebase. Gitea supports conan v2 cli (given functions like `DeleteRecipeV2` and `SearchPackagesV2`)
---------
Co-authored-by: Chongyi Zheng <[email protected] https://gitea.com/gitea/docs/pulls/426
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-05-26 07:53:05 +00:00
wxiaoguang
8b31adbc6f
fix: make DEFAULT_TITLE_SOURCE default to auto
2026-05-19 08:07:42 +00:00
54af905d63
rename act runner to runner ( #390 )
...
Depends on gitea/runner#850
---------
Co-authored-by: Nicolas <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/390
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2026-05-07 17:18:58 +00:00
wxiaoguang
b6b8dbcc64
Update SQLITE_TIMEOUT ( #419 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/419
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-05-07 12:59:34 +00:00
silverwind
5bab08db10
Note OpenSearch compatibility for elasticsearch indexer ( #417 )
...
https://github.com/go-gitea/gitea/pull/37411
---
This PR was written with the help of Claude Opus 4.7
Reviewed-on: https://gitea.com/gitea/docs/pulls/417
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-05-04 11:38:21 +00:00
Lunny Xiao
14b76120b4
update webhook documentation ( #393 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/393
2026-05-01 16:40:27 +00:00
f550d33ad7
Update SSH_ROOT_PATH / attachment comment ( #373 )
...
Co-authored-by: Lunny Xiao <[email protected] [email protected] https://gitea.com/gitea/docs/pulls/373
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-04-28 21:56:14 +00:00
0xGREG and Nicolas
e0fcc861f2
Document DEFAULT_TITLE_SOURCE pull request title setting ( #391 )
...
Adds documentation for the `DEFAULT_TITLE_SOURCE` setting.
- Added `DEFAULT_TITLE_SOURCE` to the config cheat sheet under `[repository.pull-request]`
- Added a "Default pull request title" section to the pull request usage docs explaining both modes (`first-commit` and `auto`)
---------
Co-authored-by: Nicolas <[email protected] https://gitea.com/gitea/docs/pulls/391
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-04-28 21:45:22 +00:00
Zettat123
3ef08b184a
Add MAX_RERUN_ATTEMPTS to config cheat sheet ( #383 )
...
Related https://github.com/go-gitea/gitea/pull/37119
Reviewed-on: https://gitea.com/gitea/docs/pulls/383
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-04-25 18:25:14 +00:00
silverwind and wxiaoguang
58d5c6c5e3
Add X_CONTENT_TYPE_OPTIONS ( #389 )
...
https://github.com/go-gitea/gitea/pull/37354
---
This PR was written with the help of Claude Opus 4.7
---------
Co-authored-by: wxiaoguang <[email protected] https://gitea.com/gitea/docs/pulls/389
Reviewed-by: wxiaoguang <[email protected] [email protected] [email protected]
2026-04-24 10:54:21 +00:00
wxiaoguang
76b9c25b6d
Add CUSTOM_SCHEMES ( #387 )
...
https://github.com/go-gitea/gitea/pull/37356
Reviewed-on: https://gitea.com/gitea/docs/pulls/387
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-04-22 22:10:57 +00:00
Renovate Bot
c2b6f71085
chore(deps): update docusaurus monorepo to v3.10.0 ( #374 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/374
Co-authored-by: Renovate Bot <[email protected] [email protected]
2026-04-15 15:17:27 +00:00
wxiaoguang
a939f44e37
fix typo
...
# Conflicts:
# docs/administration/reverse-proxies.md
2026-04-14 16:09:39 +08:00
silverwind
59bd79347e
Document REVERSE_PROXY_LOGOUT_REDIRECT setting ( #380 )
...
Add documentation for the new `REVERSE_PROXY_LOGOUT_REDIRECT` setting in the `[security]` section, which allows redirecting users to an external URL or relative path after logout when using reverse proxy authentication.
For Gitea 1.26, ref https://github.com/go-gitea/gitea/pull/36085 .
---
This PR was written with the help of Claude Opus 4.6
Reviewed-on: https://gitea.com/gitea/docs/pulls/380
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-04-10 16:50:43 +00:00
silverwind
5e4cd3b577
Remove obsolete actions concurrency notes ( #377 )
...
`concurrency` is fully supported as of v1.26 via https://github.com/go-gitea/gitea/pull/32751 , so remove the unsupported entry and the different-behavior note.
Closes #340
---
This PR was written with the help of Claude Opus 4.6
Reviewed-on: https://gitea.com/gitea/docs/pulls/377
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-04-08 23:08:20 +00:00
wxiaoguang
57fc84f003
remove "rootful" from title
2026-04-07 17:33:41 +08:00
kmanwar89 and wxiaoguang
9cc5cfd388
Updated various docker compose commands & references ( #361 )
...
Co-authored-by: wxiaoguang <[email protected] [email protected] [email protected]
2026-04-07 09:24:36 +00:00
TheFox0x7
1568bfa1e9
terraform state registry docs ( #357 )
...
https://github.com/go-gitea/gitea/pull/36710
Reviewed-on: https://gitea.com/gitea/docs/pulls/357
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-04-06 20:41:42 +00:00
wxiaoguang
efa6607558
GitHub-like theme-based image display ( #372 )
2026-04-03 18:25:12 +00:00
silverwind
25dce1df62
Add pre-defined variables reference to Actions docs ( #369 )
...
Add comprehensive reference tables for pre-defined variables available in Gitea Actions workflows, derived from the Gitea and act_runner source code.
## Context variables (`${{ gitea.<name> }}`)
All context variables with their `github.*` aliases and descriptions, sourced from `services/actions/context.go`.
## Environment variables
- **Standard**: `CI`, `GITEA_ACTIONS`, `GITEA_ACTIONS_RUNNER_VERSION`, `GITHUB_*`, and the 5 `GITEA_*` aliases for workflow file commands (`GITEA_ENV`, `GITEA_OUTPUT`, `GITEA_PATH`, `GITEA_STATE`, `GITEA_STEP_SUMMARY`)
- **Runner**: `RUNNER_OS`, `RUNNER_ARCH`, `RUNNER_TEMP`, `RUNNER_TOOL_CACHE`
- **Internal**: `ACTIONS_CACHE_URL`, `ACTIONS_RUNTIME_*`, etc.
Closes https://gitea.com/gitea/docs/issues/350
Reviewed-on: https://gitea.com/gitea/docs/pulls/369
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-03-28 09:27:06 +00:00
TheFox0x7
8660c68d8c
add actions cron tasks ( #371 )
...
fixes: https://github.com/go-gitea/gitea/issues/37009 for docs
Reviewed-on: https://gitea.com/gitea/docs/pulls/371
Reviewed-by: Nicolas <[email protected] [email protected] [email protected]
2026-03-27 23:38:53 +00:00
wxiaoguang
9a00f8ea0c
Sync docs/administration/config-cheat-sheet.md ( #368 )
...
Reviewed-on: https://gitea.com/gitea/docs/pulls/368
Reviewed-by: silverwind <[email protected] [email protected] [email protected]
2026-03-24 15:44:11 +00:00
Excellencedev
0c17ed264d
Add docs for configurable permissions for Actions automatic tokens ( #366 )
...
Docs for https://github.com/go-gitea/gitea/pull/36173
Reviewed-on: https://gitea.com/gitea/docs/pulls/366
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected] [email protected] [email protected]
2026-03-24 11:11:25 +00:00
silverwind
47ef41da3b
Add DEFAULT_DELETE_BRANCH_AFTER_MERGE to config cheat sheet ( #367 )
...
Add documentation for the new `[repository.pull-request]` `DEFAULT_DELETE_BRANCH_AFTER_MERGE` config option added in https://github.com/go-gitea/gitea/pull/36917 .
*This comment was written by Claude.*
Reviewed-on: https://gitea.com/gitea/docs/pulls/367
Reviewed-by: TheFox0x7 <[email protected] [email protected] [email protected]
2026-03-23 19:12:49 +00:00
silverwind
eb8ade10c7
Update environment variable docs, remove environment-to-ini references ( #355 )
...
The standalone `environment-to-ini` tool was removed in https://github.com/go-gitea/gitea/pull/35735 and its functionality is now built into the Gitea binary. This PR:
- Removes outdated links to the removed `contrib/environment-to-ini` directory
- Updates the "Use environment variables to setup Gitea" section in the config cheat sheet
- Adds examples showing how env vars map to `app.ini` settings and the `__FILE` suffix for secrets
*This PR was authored by Claude.*
Reviewed-on: https://gitea.com/gitea/docs/pulls/355
Reviewed-by: wxiaoguang <[email protected] [email protected]
2026-03-17 18:19:18 +00:00
crrdean
6cd29ccce0
Fixed pull_request action name ( #359 )
...
synchronize should be synchronized
Reviewed-on: https://gitea.com/gitea/docs/pulls/359
Reviewed-by: techknowlogick <[email protected] [email protected] [email protected]
2026-03-10 20:00:25 +00:00
silverwind
8809db41d8
Fix signed pushes documentation ( #351 )
...
Now actually tested and working. All that's needed is the nonce in the gitea config.
Reviewed-on: https://gitea.com/gitea/docs/pulls/351
Reviewed-by: Lunny Xiao <[email protected]
2026-03-08 18:20:51 +00:00
Zettat123
dc136aa31b
Add never option to PUBLIC_URL_DETECTION configuration ( #353 )
...
https://github.com/go-gitea/gitea/pull/36785
Reviewed-on: https://gitea.com/gitea/docs/pulls/353
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected]
2026-03-01 19:00:35 +00:00
iqre8
d6bd3c6fb9
Update docs/installation/with-docker.md ( #352 )
...
Removed version, and changed the command from `docker-compose` to `docker compose` and changed the tool `docker-compose` to the docker `compose`-plugin
Reviewed-on: https://gitea.com/gitea/docs/pulls/352
Reviewed-by: Lunny Xiao <[email protected] [email protected] [email protected] [email protected]
2026-02-25 20:20:32 +00:00
