Table of Contents
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, such as:
For documentation about each of the variables available, refer to the official Go documentation.
GITEA_WORK_DIR: Absolute path of working directory.
GITEA_CUSTOM: Gitea uses
GITEA_WORK_DIR/custom folder by default. Use this variable to change custom directory.
GOGS_WORK_DIR: Deprecated, use
GOGS_CUSTOM: Deprecated, use
Operating system specifics
USER: System user that Gitea will run as. Used for some repository access strings.
USERNAME: if no
USERfound, Gitea will use
HOME: User home directory path. The
USERPROFILEenvironment variable is used in Windows.
Only on Windows
USERPROFILE: User home directory path. If empty, uses
HOMEDRIVE: Main drive path used to access the home directory (C:)
HOMEPATH: Home relative path in the given home drive path
Macaron (framework used by Gitea)
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”.
SKIP_MINWINSVC: If set to 1, do not run as a service on Windows.