techknowlogick fb5c6b6444 Import docs into main repository (#2874 )

* import docs into main repository

Signed-off-by: Matti Ranta <matti@mdranta.net>

2017-11-26 23:44:32 +02:00

date

title

slug

weight

toc

draft

2017-04-08T11:34:00+02:00

Specific variables

specific-variables

false

sidebar

parent	name	weight	identifier
advanced	Specific variables	20	specific-variables

Specific variables

This is an inventory of Gitea environment variables. They change Gitea behaviour.

Initialize them before Gitea command to be effective, for example:

GITEA_CUSTOM=/home/gitea/custom ./gitea web

From Go language

As Gitea is written in Go, it uses some Go variables as:

GITEA_WORK_DIR: Gitea absolute path of work directory.
GITEA_CUSTOM: Gitea uses GITEA_WORK_DIR/custom folder by default. Use this variable to change custom directory.
GOGS_WORK_DIR: Deprecated, use GITEA_WORK_DIR
GOGS_CUSTOM: Deprecated, use GITEA_CUSTOM

USER: system user that launch Gitea. Useful for repository URL address on Gitea interface
USERNAME: if no USER found, Gitea will try USERNAME
HOME: User home directory path (except if you're running on Windows, check the following USERPROFILE variable)

USERPROFILE: User home directory path. If empty, uses HOMEDRIVE + HOMEPATH
HOMEDRIVE: Main drive path you will use to get home directory
HOMEPATH: Home relative path in the given home drive path

HOST: Host Macaron will listen on
PORT: Port Macaron will listen on
MACARON_ENV: global variable to provide special functionality for development environments vs production environments. If MACARON_ENV is set to "" or "development" then templates will be recompiled on every request. For more performance, set the MACARON_ENV environment variable to "production".