From b3a3024f038f5709bf17f93a009415785ca20475 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Timoth=C3=A9e=20Ravier?= Date: Tue, 22 May 2018 03:35:36 +0200 Subject: [PATCH] doc: update LOCAL_ROOT_URL description for PROTOCOL = 'unix' case (#3760) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Update the sample configuration and config cheat sheet description for the LOCAL_ROOT_URL configuration variable to mention the special case required if PROTOCOL is set to 'unix'. Fixes #3741. Signed-off-by: Timothée Ravier --- custom/conf/app.ini.sample | 1 + docs/content/doc/advanced/config-cheat-sheet.en-us.md | 5 +++++ 2 files changed, 6 insertions(+) diff --git a/custom/conf/app.ini.sample b/custom/conf/app.ini.sample index ca5b7a3332..f9a188c3a1 100644 --- a/custom/conf/app.ini.sample +++ b/custom/conf/app.ini.sample @@ -124,6 +124,7 @@ UNIX_SOCKET_PERMISSION = 666 ; Local (DMZ) URL for Gitea workers (such as SSH update) accessing web service. ; In 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 if PROTOCOL is set to 'unix'. LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/ ; Disable SSH feature when not available DISABLE_SSH = false diff --git a/docs/content/doc/advanced/config-cheat-sheet.en-us.md b/docs/content/doc/advanced/config-cheat-sheet.en-us.md index 16d0a50fad..0d2af62373 100644 --- a/docs/content/doc/advanced/config-cheat-sheet.en-us.md +++ b/docs/content/doc/advanced/config-cheat-sheet.en-us.md @@ -95,6 +95,11 @@ Values containing `#` or `;` must be quoted using `` ` `` or `"""`. - If `PROTOCOL` is set to `fcgi`, Gitea will listen for FastCGI requests on TCP socket defined by `HTTP_ADDR` and `HTTP_PORT` configuration settings. - `UNIX_SOCKET_PERMISSION`: **666**: Permissions for the Unix socket. +- `LOCAL_ROOT_URL`: **%(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/**: Local + (DMZ) URL for Gitea workers (such as SSH update) accessing web service. In + 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 + if `PROTOCOL` is set to `unix`. - `DISABLE_SSH`: **false**: Disable SSH feature when it's not available. - `START_SSH_SERVER`: **false**: When enabled, use the built-in SSH server. - `SSH_DOMAIN`: **%(DOMAIN)s**: Domain name of this server, used for displayed clone URL.