mirror of
				https://gitee.com/gitea/gitea
				synced 2025-11-04 16:40:24 +08:00 
			
		
		
		
	Update documentation to disable duration settings with -1 instead of 0 (#19647)
To turn off the notification endpoint polling, the value should be set to -1, not 0.
This commit is contained in:
		@@ -61,7 +61,7 @@ RUN_MODE = ; prod
 | 
				
			|||||||
;; SSL Cipher Suites
 | 
					;; SSL Cipher Suites
 | 
				
			||||||
;SSL_CIPHER_SUITES=; Will default to "ecdhe_ecdsa_with_aes_256_gcm_sha384,ecdhe_rsa_with_aes_256_gcm_sha384,ecdhe_ecdsa_with_aes_128_gcm_sha256,ecdhe_rsa_with_aes_128_gcm_sha256,ecdhe_ecdsa_with_chacha20_poly1305,ecdhe_rsa_with_chacha20_poly1305" if aes is supported by hardware, otherwise chacha will be first.
 | 
					;SSL_CIPHER_SUITES=; Will default to "ecdhe_ecdsa_with_aes_256_gcm_sha384,ecdhe_rsa_with_aes_256_gcm_sha384,ecdhe_ecdsa_with_aes_128_gcm_sha256,ecdhe_rsa_with_aes_128_gcm_sha256,ecdhe_ecdsa_with_chacha20_poly1305,ecdhe_rsa_with_chacha20_poly1305" if aes is supported by hardware, otherwise chacha will be first.
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Timeout for any write to the connection. (Set to 0 to disable all timeouts.)
 | 
					;; Timeout for any write to the connection. (Set to -1 to disable all timeouts.)
 | 
				
			||||||
;PER_WRITE_TIMEOUT = 30s
 | 
					;PER_WRITE_TIMEOUT = 30s
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Timeout per Kb written to connections.
 | 
					;; Timeout per Kb written to connections.
 | 
				
			||||||
@@ -163,7 +163,7 @@ RUN_MODE = ; prod
 | 
				
			|||||||
;; Enable exposure of SSH clone URL to anonymous visitors, default is false
 | 
					;; Enable exposure of SSH clone URL to anonymous visitors, default is false
 | 
				
			||||||
;SSH_EXPOSE_ANONYMOUS = false
 | 
					;SSH_EXPOSE_ANONYMOUS = false
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Timeout for any write to ssh connections. (Set to 0 to disable all timeouts.)
 | 
					;; Timeout for any write to ssh connections. (Set to -1 to disable all timeouts.)
 | 
				
			||||||
;; Will default to the PER_WRITE_TIMEOUT.
 | 
					;; Will default to the PER_WRITE_TIMEOUT.
 | 
				
			||||||
;SSH_PER_WRITE_TIMEOUT = 30s
 | 
					;SSH_PER_WRITE_TIMEOUT = 30s
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
@@ -1178,7 +1178,7 @@ PATH =
 | 
				
			|||||||
;;
 | 
					;;
 | 
				
			||||||
;; Control how often the notification endpoint is polled to update the notification
 | 
					;; Control how often the notification endpoint is polled to update the notification
 | 
				
			||||||
;; The timeout will increase to MAX_TIMEOUT in TIMEOUT_STEPs if the notification count is unchanged
 | 
					;; The timeout will increase to MAX_TIMEOUT in TIMEOUT_STEPs if the notification count is unchanged
 | 
				
			||||||
;; Set MIN_TIMEOUT to 0 to turn off
 | 
					;; Set MIN_TIMEOUT to -1 to turn off
 | 
				
			||||||
;MIN_TIMEOUT = 10s
 | 
					;MIN_TIMEOUT = 10s
 | 
				
			||||||
;MAX_TIMEOUT = 60s
 | 
					;MAX_TIMEOUT = 60s
 | 
				
			||||||
;TIMEOUT_STEP = 10s
 | 
					;TIMEOUT_STEP = 10s
 | 
				
			||||||
@@ -1263,7 +1263,7 @@ PATH =
 | 
				
			|||||||
;ISSUE_INDEXER_NAME = gitea_issues
 | 
					;ISSUE_INDEXER_NAME = gitea_issues
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Timeout the indexer if it takes longer than this to start.
 | 
					;; Timeout the indexer if it takes longer than this to start.
 | 
				
			||||||
;; Set to zero to disable timeout.
 | 
					;; Set to -1 to disable timeout.
 | 
				
			||||||
;STARTUP_TIMEOUT = 30s
 | 
					;STARTUP_TIMEOUT = 30s
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Issue indexer queue, currently support: channel, levelqueue or redis, default is levelqueue (deprecated - use [queue.issue_indexer])
 | 
					;; Issue indexer queue, currently support: channel, levelqueue or redis, default is levelqueue (deprecated - use [queue.issue_indexer])
 | 
				
			||||||
@@ -1582,7 +1582,7 @@ PATH =
 | 
				
			|||||||
;HOST =
 | 
					;HOST =
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Time to keep items in cache if not used, default is 16 hours.
 | 
					;; Time to keep items in cache if not used, default is 16 hours.
 | 
				
			||||||
;; Setting it to 0 disables caching
 | 
					;; Setting it to -1 disables caching
 | 
				
			||||||
;ITEM_TTL = 16h
 | 
					;ITEM_TTL = 16h
 | 
				
			||||||
 | 
					
 | 
				
			||||||
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 | 
					;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 | 
				
			||||||
@@ -1596,7 +1596,7 @@ PATH =
 | 
				
			|||||||
;ENABLED = true
 | 
					;ENABLED = true
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Time to keep items in cache if not used, default is 8760 hours.
 | 
					;; Time to keep items in cache if not used, default is 8760 hours.
 | 
				
			||||||
;; Setting it to 0 disables caching
 | 
					;; Setting it to -1 disables caching
 | 
				
			||||||
;ITEM_TTL = 8760h
 | 
					;ITEM_TTL = 8760h
 | 
				
			||||||
;;
 | 
					;;
 | 
				
			||||||
;; Only enable the cache when repository's commits count great than
 | 
					;; Only enable the cache when repository's commits count great than
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -206,7 +206,7 @@ The following configuration set `Content-Type: application/vnd.android.package-a
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
### UI - Notification (`ui.notification`)
 | 
					### UI - Notification (`ui.notification`)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `MIN_TIMEOUT`: **10s**: These options control how often notification endpoint is polled to update the notification count. On page load the notification count will be checked after `MIN_TIMEOUT`. The timeout will increase to `MAX_TIMEOUT` by `TIMEOUT_STEP` if the notification count is unchanged. Set MIN_TIMEOUT to 0 to turn off.
 | 
					- `MIN_TIMEOUT`: **10s**: These options control how often notification endpoint is polled to update the notification count. On page load the notification count will be checked after `MIN_TIMEOUT`. The timeout will increase to `MAX_TIMEOUT` by `TIMEOUT_STEP` if the notification count is unchanged. Set MIN_TIMEOUT to -1 to turn off.
 | 
				
			||||||
- `MAX_TIMEOUT`: **60s**.
 | 
					- `MAX_TIMEOUT`: **60s**.
 | 
				
			||||||
- `TIMEOUT_STEP`: **10s**.
 | 
					- `TIMEOUT_STEP`: **10s**.
 | 
				
			||||||
- `EVENT_SOURCE_UPDATE_TIME`: **10s**: This setting determines how often the database is queried to update notification counts. If the browser client supports `EventSource` and `SharedWorker`, a `SharedWorker` will be used in preference to polling notification endpoint. Set to **-1** to disable the `EventSource`.
 | 
					- `EVENT_SOURCE_UPDATE_TIME`: **10s**: This setting determines how often the database is queried to update notification counts. If the browser client supports `EventSource` and `SharedWorker`, a `SharedWorker` will be used in preference to polling notification endpoint. Set to **-1** to disable the `EventSource`.
 | 
				
			||||||
@@ -258,7 +258,7 @@ The following configuration set `Content-Type: application/vnd.android.package-a
 | 
				
			|||||||
   most cases you do not need to change the default value. Alter it only if
 | 
					   most cases you do not need to change the default value. Alter it only if
 | 
				
			||||||
   your SSH server node is not the same as HTTP node. Do not set this variable
 | 
					   your SSH server node is not the same as HTTP node. Do not set this variable
 | 
				
			||||||
   if `PROTOCOL` is set to `http+unix`.
 | 
					   if `PROTOCOL` is set to `http+unix`.
 | 
				
			||||||
- `PER_WRITE_TIMEOUT`: **30s**: Timeout for any write to the connection. (Set to 0 to
 | 
					- `PER_WRITE_TIMEOUT`: **30s**: Timeout for any write to the connection. (Set to -1 to
 | 
				
			||||||
   disable all timeouts.)
 | 
					   disable all timeouts.)
 | 
				
			||||||
- `PER_WRITE_PER_KB_TIMEOUT`: **10s**: Timeout per Kb written to connections.
 | 
					- `PER_WRITE_PER_KB_TIMEOUT`: **10s**: Timeout per Kb written to connections.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -287,7 +287,7 @@ The following configuration set `Content-Type: application/vnd.android.package-a
 | 
				
			|||||||
- `SSH_KEYGEN_PATH`: **ssh-keygen**: Path to ssh-keygen, default is 'ssh-keygen' which means the shell is responsible for finding out which one to call.
 | 
					- `SSH_KEYGEN_PATH`: **ssh-keygen**: Path to ssh-keygen, default is 'ssh-keygen' which means the shell is responsible for finding out which one to call.
 | 
				
			||||||
- `SSH_EXPOSE_ANONYMOUS`: **false**: Enable exposure of SSH clone URL to anonymous visitors, default is false.
 | 
					- `SSH_EXPOSE_ANONYMOUS`: **false**: Enable exposure of SSH clone URL to anonymous visitors, default is false.
 | 
				
			||||||
- `SSH_PER_WRITE_TIMEOUT`: **30s**: Timeout for any write to the SSH connections. (Set to
 | 
					- `SSH_PER_WRITE_TIMEOUT`: **30s**: Timeout for any write to the SSH connections. (Set to
 | 
				
			||||||
  0 to disable all timeouts.)
 | 
					  -1 to disable all timeouts.)
 | 
				
			||||||
- `SSH_PER_WRITE_PER_KB_TIMEOUT`: **10s**: Timeout per Kb written to SSH connections.
 | 
					- `SSH_PER_WRITE_PER_KB_TIMEOUT`: **10s**: Timeout per Kb written to SSH connections.
 | 
				
			||||||
- `MINIMUM_KEY_SIZE_CHECK`: **true**: Indicate whether to check minimum key size with corresponding type.
 | 
					- `MINIMUM_KEY_SIZE_CHECK`: **true**: Indicate whether to check minimum key size with corresponding type.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -415,7 +415,7 @@ relation to port exhaustion.
 | 
				
			|||||||
- `REPO_INDEXER_EXCLUDE_VENDORED`: **true**: Exclude vendored files from index.
 | 
					- `REPO_INDEXER_EXCLUDE_VENDORED`: **true**: Exclude vendored files from index.
 | 
				
			||||||
- `UPDATE_BUFFER_LEN`: **20**: Buffer length of index request. **DEPRECATED** use settings in `[queue.issue_indexer]`.
 | 
					- `UPDATE_BUFFER_LEN`: **20**: Buffer length of index request. **DEPRECATED** use settings in `[queue.issue_indexer]`.
 | 
				
			||||||
- `MAX_FILE_SIZE`: **1048576**: Maximum size in bytes of files to be indexed.
 | 
					- `MAX_FILE_SIZE`: **1048576**: Maximum size in bytes of files to be indexed.
 | 
				
			||||||
- `STARTUP_TIMEOUT`: **30s**: If the indexer takes longer than this timeout to start - fail. (This timeout will be added to the hammer time above for child processes - as bleve will not start until the previous parent is shutdown.) Set to zero to never timeout.
 | 
					- `STARTUP_TIMEOUT`: **30s**: If the indexer takes longer than this timeout to start - fail. (This timeout will be added to the hammer time above for child processes - as bleve will not start until the previous parent is shutdown.) Set to -1 to never timeout.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Queue (`queue` and `queue.*`)
 | 
					## Queue (`queue` and `queue.*`)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
@@ -687,12 +687,12 @@ Define allowed algorithms and their minimum key length (use -1 to disable a type
 | 
				
			|||||||
   - Redis: `redis://:macaron@127.0.0.1:6379/0?pool_size=100&idle_timeout=180s`
 | 
					   - Redis: `redis://:macaron@127.0.0.1:6379/0?pool_size=100&idle_timeout=180s`
 | 
				
			||||||
   - Memcache: `127.0.0.1:9090;127.0.0.1:9091`
 | 
					   - Memcache: `127.0.0.1:9090;127.0.0.1:9091`
 | 
				
			||||||
   - TwoQueue LRU cache: `{"size":50000,"recent_ratio":0.25,"ghost_ratio":0.5}` or `50000` representing the maximum number of objects stored in the cache.
 | 
					   - TwoQueue LRU cache: `{"size":50000,"recent_ratio":0.25,"ghost_ratio":0.5}` or `50000` representing the maximum number of objects stored in the cache.
 | 
				
			||||||
- `ITEM_TTL`: **16h**: Time to keep items in cache if not used, Setting it to 0 disables caching.
 | 
					- `ITEM_TTL`: **16h**: Time to keep items in cache if not used, Setting it to -1 disables caching.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Cache - LastCommitCache settings (`cache.last_commit`)
 | 
					## Cache - LastCommitCache settings (`cache.last_commit`)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `ENABLED`: **true**: Enable the cache.
 | 
					- `ENABLED`: **true**: Enable the cache.
 | 
				
			||||||
- `ITEM_TTL`: **8760h**: Time to keep items in cache if not used, Setting it to 0 disables caching.
 | 
					- `ITEM_TTL`: **8760h**: Time to keep items in cache if not used, Setting it to -1 disables caching.
 | 
				
			||||||
- `COMMITS_COUNT`: **1000**: Only enable the cache when repository's commits count great than.
 | 
					- `COMMITS_COUNT`: **1000**: Only enable the cache when repository's commits count great than.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Session (`session`)
 | 
					## Session (`session`)
 | 
				
			||||||
 
 | 
				
			|||||||
@@ -175,12 +175,12 @@ menu:
 | 
				
			|||||||
- `HOST`: **\<empty\>**: 针对redis和memcache有效,主机地址和端口。
 | 
					- `HOST`: **\<empty\>**: 针对redis和memcache有效,主机地址和端口。
 | 
				
			||||||
    - Redis: `network=tcp,addr=127.0.0.1:6379,password=macaron,db=0,pool_size=100,idle_timeout=180`
 | 
					    - Redis: `network=tcp,addr=127.0.0.1:6379,password=macaron,db=0,pool_size=100,idle_timeout=180`
 | 
				
			||||||
    - Memache: `127.0.0.1:9090;127.0.0.1:9091`
 | 
					    - Memache: `127.0.0.1:9090;127.0.0.1:9091`
 | 
				
			||||||
- `ITEM_TTL`: **16h**: 缓存项目失效时间,设置为 0 则禁用缓存。
 | 
					- `ITEM_TTL`: **16h**: 缓存项目失效时间,设置为 -1 则禁用缓存。
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Cache - LastCommitCache settings (`cache.last_commit`)
 | 
					## Cache - LastCommitCache settings (`cache.last_commit`)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
- `ENABLED`: **true**: 是否启用。
 | 
					- `ENABLED`: **true**: 是否启用。
 | 
				
			||||||
- `ITEM_TTL`: **8760h**: 缓存项目失效时间,设置为 0 则禁用缓存。
 | 
					- `ITEM_TTL`: **8760h**: 缓存项目失效时间,设置为 -1 则禁用缓存。
 | 
				
			||||||
- `COMMITS_COUNT`: **1000**: 仅当仓库的提交数大于时才启用缓存。
 | 
					- `COMMITS_COUNT`: **1000**: 仅当仓库的提交数大于时才启用缓存。
 | 
				
			||||||
 | 
					
 | 
				
			||||||
## Session (`session`)
 | 
					## Session (`session`)
 | 
				
			||||||
 
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user