@@ -78,8 +78,9 @@ RUN_USER = ; git
7878; ; Set the domain for the server
7979; DOMAIN = localhost
8080; ;
81- ; ; Overwrite the automatically generated public URL. Necessary for proxies and docker.
82- ; ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
81+ ; ; The AppURL used by Gitea to generate absolute links, defaults to "{PROTOCOL}://{DOMAIN}:{HTTP_PORT}/".
82+ ; ; Most users should set it to the real website URL of their Gitea instance.
83+ ; ROOT_URL =
8384; ;
8485; ; For development purpose only. It makes Gitea handle sub-path ("/sub-path/owner/repo/...") directly when debugging without a reverse proxy.
8586; ; DO NOT USE IT IN PRODUCTION!!!
@@ -103,8 +104,8 @@ RUN_USER = ; git
103104; REDIRECT_OTHER_PORT = false
104105; PORT_TO_REDIRECT = 80
105106; ;
106- ; ; expect PROXY protocol header on connections to https redirector.
107- ; REDIRECTOR_USE_PROXY_PROTOCOL = %(USE_PROXY_PROTOCOL)s
107+ ; ; expect PROXY protocol header on connections to https redirector, defaults to USE_PROXY_PROTOCOL
108+ ; REDIRECTOR_USE_PROXY_PROTOCOL =
108109; ; Minimum and maximum supported TLS versions
109110; SSL_MIN_VERSION=TLSv1.2
110111; SSL_MAX_VERSION=
@@ -128,13 +129,14 @@ RUN_USER = ; git
128129; ; most cases you do not need to change the default value. Alter it only if
129130; ; your SSH server node is not the same as HTTP node. For different protocol, the default
130131; ; values are different. If `PROTOCOL` is `http+unix`, the default value is `http://unix/`.
131- ; ; If `PROTOCOL` is `fcgi` or `fcgi+unix`, the default value is `%(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/`.
132- ; ; If listen on `0.0.0.0`, the default value is `%(PROTOCOL)s://localhost:%(HTTP_PORT)s/`, Otherwise the default
133- ; ; value is `%(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/`.
134- ; LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/
132+ ; ; If `PROTOCOL` is `fcgi` or `fcgi+unix`, the default value is `{PROTOCOL}://{HTTP_ADDR}:{HTTP_PORT}/`.
133+ ; ; If listen on `0.0.0.0`, the default value is `{PROTOCOL}://localhost:{HTTP_PORT}/`.
134+ ; ; Otherwise the default value is `{PROTOCOL}://{HTTP_ADDR}:{HTTP_PORT}/`.
135+ ; ; Most users don't need (and shouldn't) set this value.
136+ ; LOCAL_ROOT_URL =
135137; ;
136- ; ; When making local connections pass the PROXY protocol header.
137- ; LOCAL_USE_PROXY_PROTOCOL = %(USE_PROXY_PROTOCOL)s
138+ ; ; When making local connections pass the PROXY protocol header, defaults to USE_PROXY_PROTOCOL
139+ ; LOCAL_USE_PROXY_PROTOCOL =
138140; ;
139141; ; Disable SSH feature when not available
140142; DISABLE_SSH = false
@@ -146,22 +148,26 @@ RUN_USER = ; git
146148; SSH_SERVER_USE_PROXY_PROTOCOL = false
147149; ;
148150; ; Username to use for the builtin SSH server. If blank, then it is the value of RUN_USER.
149- ; BUILTIN_SSH_SERVER_USER = %(RUN_USER)s
151+ ; BUILTIN_SSH_SERVER_USER =
150152; ;
151- ; ; Domain name to be exposed in clone URL
152- ; SSH_DOMAIN = %(DOMAIN)s
153+ ; ; Domain name to be exposed in clone URL, defaults to DOMAIN or the domain part of ROOT_URL
154+ ; SSH_DOMAIN =
153155; ;
154- ; ; SSH username displayed in clone URLs.
155- ; SSH_USER = %(BUILTIN_SSH_SERVER_USER)s
156+ ; ; SSH username displayed in clone URLs. It defaults to BUILTIN_SSH_SERVER_USER or RUN_USER.
157+ ; ; If it is set to "(DOER_USERNAME)", it will use current signed-in user's username.
158+ ; ; This option is only for some advanced users who have configured their SSH reverse-proxy
159+ ; ; and need to use different usernames for git SSH clone.
160+ ; ; Most users should just leave it blank.
161+ ; SSH_USER =
156162; ;
157163; ; The network interface the builtin SSH server should listen on
158164; SSH_LISTEN_HOST =
159165; ;
160166; ; Port number to be exposed in clone URL
161167; SSH_PORT = 22
162168; ;
163- ; ; The port number the builtin SSH server should listen on
164- ; SSH_LISTEN_PORT = %(SSH_PORT)s
169+ ; ; The port number the builtin SSH server should listen on, defaults to SSH_PORT
170+ ; SSH_LISTEN_PORT =
165171; ;
166172; ; Root path of SSH directory, default is '~/.ssh', but you have to use '/home/git/.ssh'.
167173; SSH_ROOT_PATH =
@@ -188,7 +194,7 @@ RUN_USER = ; git
188194; ;
189195; ; For the built-in SSH server, choose the keypair to offer as the host key
190196; ; The private key should be at SSH_SERVER_HOST_KEY and the public SSH_SERVER_HOST_KEY.pub
191- ; ; relative paths are made absolute relative to the %( APP_DATA_PATH)s
197+ ; ; relative paths are made absolute relative to the APP_DATA_PATH
192198; SSH_SERVER_HOST_KEYS=ssh/gitea.rsa, ssh/gogs.rsa
193199; ;
194200; ; Directory to create temporary files in when testing public keys using ssh-keygen,
@@ -582,7 +588,7 @@ ENABLED = true
582588[log]
583589; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
584590; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
585- ; ; Root path for the log files - defaults to %(GITEA_WORK_DIR) /log
591+ ; ; Root path for the log files - defaults to "{AppWorkPath} /log"
586592; ROOT_PATH =
587593; ;
588594; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
@@ -682,8 +688,8 @@ LEVEL = Info
682688; ; The path of git executable. If empty, Gitea searches through the PATH environment.
683689; PATH =
684690; ;
685- ; ; The HOME directory for Git
686- ; HOME_PATH = %(APP_DATA_PATH)s/home
691+ ; ; The HOME directory for Git, defaults to "{APP_DATA_PATH}/home"
692+ ; HOME_PATH =
687693; ;
688694; ; Disables highlight of added and removed changes
689695; DISABLE_DIFF_HIGHLIGHT = false
@@ -946,8 +952,8 @@ LEVEL = Info
946952; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
947953; [repository]
948954; ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
949- ; ; Root path for storing all repository data. By default, it is set to %( APP_DATA_PATH)s /gitea-repositories.
950- ; ; A relative path is interpreted as _` AppWorkPath`_/%( ROOT)s
955+ ; ; Root path for storing all repository data. By default, it is set to "{ APP_DATA_PATH} /gitea-repositories" .
956+ ; ; A relative path is interpreted as "{ AppWorkPath}/{ ROOT}" (use AppWorkPath as base path).
951957; ROOT =
952958; ;
953959; ; The script type this server supports. Usually this is `bash`, but some users report that only `sh` is available.
@@ -1506,7 +1512,8 @@ LEVEL = Info
15061512; TYPE = persistable-channel
15071513; ;
15081514; ; data-dir for storing persistable queues and level queues, individual queues will default to `queues/common` meaning the queue is shared.
1509- ; DATADIR = queues/ ; Relative paths will be made absolute against `%(APP_DATA_PATH)s`.
1515+ ; ; Relative paths will be made absolute against "APP_DATA_PATH"
1516+ ; DATADIR = queues/
15101517; ;
15111518; ; Default queue length before a channel queue will block
15121519; LENGTH = 100000
0 commit comments