2017-11-26 04:16:58 -05:00
; This file lists the default values used by Gitea
; Copy required sections to your own app.ini (default is custom/conf/app.ini)
; and modify as needed.
2021-01-12 19:49:52 -05:00
; Do not copy the whole file as-is, as it contains some invalid sections for illustrative purposes.
; If you don't know what a setting is you should not set it.
2017-11-26 04:16:58 -05:00
2018-05-10 21:43:46 -04:00
; see https://docs.gitea.io/en-us/config-cheat-sheet/ for additional documentation.
; App name that shows in every page title
2016-11-07 08:26:13 -05:00
APP_NAME = Gitea: Git with a cup of tea
2014-03-25 06:54:22 -04:00
; Change it if you run locally
2014-03-25 06:52:56 -04:00
RUN_USER = git
2020-11-30 14:52:04 -05:00
; Application run mode, affects performance and debugging. Either "dev", "prod" or "test", default is "prod"
RUN_MODE = prod
2014-02-20 01:53:56 -05:00
2020-08-16 23:07:38 -04:00
[project]
; Default templates for project boards
PROJECT_BOARD_BASIC_KANBAN_TYPE = To Do, In Progress, Done
PROJECT_BOARD_BUG_TRIAGE_TYPE = Needs Triage, High Priority, Low Priority, Closed
2014-02-20 01:53:56 -05:00
[repository]
2020-12-15 16:52:59 -05:00
; Root path for storing all repository data. It must be an absolute path. By default it is stored in a sub-directory of `APP_DATA_PATH`.
2014-08-30 09:12:53 -04:00
ROOT =
2020-12-15 16:52:59 -05:00
; The script type this server supports. Usually this is `bash`, but some users report that only `sh` is available.
2014-04-19 06:00:08 -04:00
SCRIPT_TYPE = bash
2020-06-02 18:20:19 -04:00
; DETECTED_CHARSETS_ORDER tie-break order for detected charsets.
; If the charsets have equal confidence, tie-breaking will be done by order in this list
; with charsets earlier in the list chosen in preference to those later.
2020-06-10 14:35:27 -04:00
; Adding "defaults" will place the unused charsets at that position.
2020-11-28 01:12:22 -05:00
DETECTED_CHARSETS_ORDER = UTF-8, UTF-16BE, UTF-16LE, UTF-32BE, UTF-32LE, ISO-8859, windows-1252, ISO-8859, windows-1250, ISO-8859, ISO-8859, ISO-8859, windows-1253, ISO-8859, windows-1255, ISO-8859, windows-1251, windows-1256, KOI8-R, ISO-8859, windows-1254, Shift_JIS, GB18030, EUC-JP, EUC-KR, Big5, ISO-2022, ISO-2022, ISO-2022, IBM424_rtl, IBM424_ltr, IBM420_rtl, IBM420_ltr
2020-06-02 18:20:19 -04:00
; Default ANSI charset to override non-UTF-8 charsets to
2016-06-29 11:11:00 -04:00
ANSI_CHARSET =
2015-10-25 04:26:26 -04:00
; Force every new repository to be private
FORCE_PRIVATE = false
2018-05-10 21:43:46 -04:00
; Default privacy setting when creating a new repository, allowed values: last, private, public. Default is last which means the last setting used.
2017-12-20 07:59:56 -05:00
DEFAULT_PRIVATE = last
2020-09-27 15:20:52 -04:00
; Default private when using push-to-create
DEFAULT_PUSH_CREATE_PRIVATE = true
2018-05-10 21:43:46 -04:00
; Global limit of repositories per user, applied at creation time. -1 means no limit
2015-12-11 10:13:19 -05:00
MAX_CREATION_LIMIT = -1
2016-08-30 19:18:33 -04:00
; Mirror sync queue length, increase if mirror syncing starts hanging
MIRROR_QUEUE_LENGTH = 1000
; Patch test queue length, increase if pull request patch testing starts hanging
PULL_REQUEST_QUEUE_LENGTH = 1000
2016-08-28 03:06:22 -04:00
; Preferred Licenses to place at the top of the List
2018-05-10 21:43:46 -04:00
; The name here must match the filename in conf/license or custom/conf/license
2016-08-28 03:06:22 -04:00
PREFERRED_LICENSES = Apache License 2.0,MIT License
2018-05-10 21:43:46 -04:00
; Disable the ability to interact with repositories using the HTTP protocol
2016-10-04 12:59:07 -04:00
DISABLE_HTTP_GIT = false
2019-01-14 16:05:27 -05:00
; Value for Access-Control-Allow-Origin header, default is not to present
; WARNING: This maybe harmful to you website if you do not give it a right value.
2019-04-02 03:48:31 -04:00
ACCESS_CONTROL_ALLOW_ORIGIN =
2017-08-26 09:57:41 -04:00
; Force ssh:// clone url instead of scp-style uri when default SSH port is used
USE_COMPAT_SSH_URI = false
2019-02-10 14:27:19 -05:00
; Close issues as long as a commit on any branch marks it as fixed
DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH = false
2019-12-14 21:49:52 -05:00
; Allow users to push local repositories to Gitea and have them automatically created for a user or an org
ENABLE_PUSH_CREATE_USER = false
ENABLE_PUSH_CREATE_ORG = false
2020-01-17 02:34:37 -05:00
; Comma separated list of globally disabled repo units. Allowed values: repo.issues, repo.ext_issues, repo.pulls, repo.wiki, repo.ext_wiki
2020-02-01 14:11:32 -05:00
DISABLED_REPO_UNITS =
2020-08-16 23:07:38 -04:00
; Comma separated list of default repo units. Allowed values: repo.code, repo.releases, repo.issues, repo.pulls, repo.wiki, repo.projects.
2020-01-17 02:34:37 -05:00
; Note: Code and Releases can currently not be deactivated. If you specify default repo units you should still list them for future compatibility.
; External wiki and issue tracker can't be enabled by default as it requires additional settings.
; Disabled repo units will not be added to new repositories regardless if it is in the default list.
2020-08-16 23:07:38 -04:00
DEFAULT_REPO_UNITS = repo.code,repo.releases,repo.issues,repo.pulls,repo.wiki,repo.projects
2020-01-22 18:46:46 -05:00
; Prefix archive files by placing them in a directory named after the repository
PREFIX_ARCHIVE_FILES = true
2020-06-02 21:21:38 -04:00
; Disable the creation of new mirrors. Pre-existing mirrors remain valid.
DISABLE_MIRRORS = false
2020-12-21 09:39:41 -05:00
; Disable migrating feature.
DISABLE_MIGRATIONS = false
2020-06-17 16:53:55 -04:00
; The default branch name of new repositories
2020-11-28 01:12:22 -05:00
DEFAULT_BRANCH = master
2020-09-25 00:09:23 -04:00
; Allow adoption of unadopted repositories
2020-11-28 01:12:22 -05:00
ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES = false
2020-09-25 00:09:23 -04:00
; Allow deletion of unadopted repositories
2020-11-28 01:12:22 -05:00
ALLOW_DELETION_OF_UNADOPTED_REPOSITORIES = false
2014-02-12 14:54:09 -05:00
2016-08-12 05:29:29 -04:00
[repository.editor]
2020-05-14 12:06:01 -04:00
; List of file extensions for which lines should be wrapped in the Monaco editor
2018-05-10 21:43:46 -04:00
; Separate extensions with a comma. To line wrap files without an extension, just put a comma
2016-08-11 08:48:08 -04:00
LINE_WRAP_EXTENSIONS = .txt,.md,.markdown,.mdown,.mkd,
; Valid file modes that have a preview API associated with them, such as api/v1/markdown
2018-05-10 21:43:46 -04:00
; Separate the values by commas. The preview tab in edit mode won't be displayed if the file extension doesn't match
2016-08-12 05:29:29 -04:00
PREVIEWABLE_FILE_MODES = markdown
2016-08-11 08:48:08 -04:00
2017-06-06 05:09:54 -04:00
[repository.local]
2018-01-28 12:16:28 -05:00
; Path for local repository copy. Defaults to `tmp/local-repo`
2017-06-06 05:09:54 -04:00
LOCAL_COPY_PATH = tmp/local-repo
2016-08-12 05:29:29 -04:00
[repository.upload]
2016-08-11 08:48:08 -04:00
; Whether repository file uploads are enabled. Defaults to `true`
2016-08-12 05:29:29 -04:00
ENABLED = true
2016-11-07 08:26:13 -05:00
; Path for uploads. Defaults to `data/tmp/uploads` (tmp gets deleted on gitea restart)
2016-08-11 08:48:08 -04:00
TEMP_PATH = data/tmp/uploads
2020-10-05 01:49:33 -04:00
; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
2016-08-11 08:48:08 -04:00
ALLOWED_TYPES =
2018-05-10 21:43:46 -04:00
; Max size of each file in megabytes. Defaults to 3MB
2016-08-30 08:07:50 -04:00
FILE_MAX_SIZE = 3
; Max number of files per upload. Defaults to 5
MAX_FILES = 5
2016-08-11 08:48:08 -04:00
2018-08-13 15:04:39 -04:00
[repository.pull-request]
; List of prefixes used in Pull Request title to mark them as Work In Progress
2020-11-28 01:12:22 -05:00
WORK_IN_PROGRESS_PREFIXES = WIP:,[WIP]
2019-10-30 08:43:59 -04:00
; List of keywords used in Pull Request comments to automatically close a related issue
2020-11-28 01:12:22 -05:00
CLOSE_KEYWORDS = close,closes,closed,fix,fixes,fixed,resolve,resolves,resolved
2019-10-30 08:43:59 -04:00
; List of keywords used in Pull Request comments to automatically reopen a related issue
2020-11-28 01:12:22 -05:00
REOPEN_KEYWORDS = reopen,reopens,reopened
2019-12-30 18:34:11 -05:00
; In the default merge message for squash commits include at most this many commits
2020-11-28 01:12:22 -05:00
DEFAULT_MERGE_MESSAGE_COMMITS_LIMIT = 50
2019-12-30 18:34:11 -05:00
; In the default merge message for squash commits limit the size of the commit messages to this
2020-11-28 01:12:22 -05:00
DEFAULT_MERGE_MESSAGE_SIZE = 5120
2019-12-30 18:34:11 -05:00
; In the default merge message for squash commits walk all commits to include all authors in the Co-authored-by otherwise just use those in the limited list
2020-11-28 01:12:22 -05:00
DEFAULT_MERGE_MESSAGE_ALL_AUTHORS = false
2019-12-30 18:34:11 -05:00
; In default merge messages limit the number of approvers listed as Reviewed-by: to this many
2020-11-28 01:12:22 -05:00
DEFAULT_MERGE_MESSAGE_MAX_APPROVERS = 10
2019-12-30 18:34:11 -05:00
; In default merge messages only include approvers who are official
2020-11-28 01:12:22 -05:00
DEFAULT_MERGE_MESSAGE_OFFICIAL_APPROVERS_ONLY = true
2018-08-13 15:04:39 -04:00
2019-02-18 15:55:04 -05:00
[repository.issue]
; List of reasons why a Pull Request or Issue can be locked
2020-11-28 01:12:22 -05:00
LOCK_REASONS = Too heated,Off-topic,Resolved,Spam
2019-02-18 15:55:04 -05:00
2020-10-05 01:49:33 -04:00
[repository.release]
; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
ALLOWED_TYPES =
2019-10-16 09:42:42 -04:00
[repository.signing]
; GPG key to use to sign commits, Defaults to the default - that is the value of git config --get user.signingkey
; run in the context of the RUN_USER
; Switch to none to stop signing completely
SIGNING_KEY = default
; If a SIGNING_KEY ID is provided and is not set to default, use the provided Name and Email address as the signer.
; These should match a publicized name and email address for the key. (When SIGNING_KEY is default these are set to
; the results of git config --get user.name and git config --get user.email respectively and can only be overrided
; by setting the SIGNING_KEY ID to the correct ID.)
SIGNING_NAME =
SIGNING_EMAIL =
2020-09-19 12:44:55 -04:00
; Sets the default trust model for repositories. Options are: collaborator, committer, collaboratorcommitter
2020-11-28 01:12:22 -05:00
DEFAULT_TRUST_MODEL = collaborator
2019-10-16 09:42:42 -04:00
; Determines when gitea should sign the initial commit when creating a repository
; Either:
; - never
; - pubkey: only sign if the user has a pubkey
; - twofa: only sign if the user has logged in with twofa
; - always
; options other than none and always can be combined as comma separated list
INITIAL_COMMIT = always
; Determines when to sign for CRUD actions
; - as above
; - parentsigned: requires that the parent commit is signed.
CRUD_ACTIONS = pubkey, twofa, parentsigned
; Determines when to sign Wiki commits
; - as above
WIKI = never
; Determines when to sign on merges
; - basesigned: require that the parent of commit on the base repo is signed.
; - commitssigned: require that all the commits in the head branch are signed.
2019-12-15 06:06:31 -05:00
; - approved: only sign when merging an approved pr to a protected branch
2019-10-16 09:42:42 -04:00
MERGES = pubkey, twofa, basesigned, commitssigned
2019-05-13 11:38:53 -04:00
[cors]
; More information about CORS can be found here: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#The_HTTP_response_headers
; enable cors headers (disabled by default)
2020-11-28 01:12:22 -05:00
ENABLED = false
2019-05-13 11:38:53 -04:00
; scheme of allowed requests
2020-11-28 01:12:22 -05:00
SCHEME = http
2019-05-13 11:38:53 -04:00
; list of requesting domains that are allowed
2020-11-28 01:12:22 -05:00
ALLOW_DOMAIN = *
2019-05-13 11:38:53 -04:00
; allow subdomains of headers listed above to request
2020-11-28 01:12:22 -05:00
ALLOW_SUBDOMAIN = false
2019-05-13 11:38:53 -04:00
; list of methods allowed to request
2020-11-28 01:12:22 -05:00
METHODS = GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS
2019-05-13 11:38:53 -04:00
; max time to cache response
2020-11-28 01:12:22 -05:00
MAX_AGE = 10m
2019-05-13 11:38:53 -04:00
; allow request with credentials
2020-11-28 01:12:22 -05:00
ALLOW_CREDENTIALS = false
2019-05-13 11:38:53 -04:00
2015-07-24 14:52:25 -04:00
[ui]
2018-05-10 21:43:46 -04:00
; Number of repositories that are displayed on one explore page
2015-09-01 07:04:35 -04:00
EXPLORE_PAGING_NUM = 20
2018-05-10 21:43:46 -04:00
; Number of issues that are displayed on one page
2015-07-24 14:52:25 -04:00
ISSUE_PAGING_NUM = 10
2018-05-10 21:43:46 -04:00
; Number of maximum commits displayed in one activity feed
2015-09-25 20:35:56 -04:00
FEED_MAX_COMMIT_NUM = 5
2020-08-11 10:48:13 -04:00
; Number of items that are displayed in home feed
FEED_PAGING_NUM = 20
2018-07-23 10:12:06 -04:00
; Number of maximum commits displayed in commit graph.
GRAPH_MAX_COMMIT_NUM = 100
2018-08-06 00:43:22 -04:00
; Number of line of codes shown for a code comment
CODE_COMMENT_LINES = 4
2016-02-08 14:03:18 -05:00
; Value of `theme-color` meta tag, used by Android >= 5.0
; An invalid color like "none" or "disable" will have the default style
; More info: https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android
2016-12-20 08:54:22 -05:00
THEME_COLOR_META_TAG = `#6cc644`
2018-05-10 21:43:46 -04:00
; Max size of files to be displayed (default is 8MiB)
2016-07-11 18:21:26 -04:00
MAX_DISPLAY_FILE_SIZE = 8388608
2018-05-10 21:43:46 -04:00
; Whether the email of the user should be shown in the Explore Users page
2016-12-31 21:51:10 -05:00
SHOW_USER_EMAIL = true
2018-07-05 17:25:04 -04:00
; Set the default theme for the Gitea install
DEFAULT_THEME = gitea
2019-01-17 14:48:01 -05:00
; All available themes. Allow users select personalized themes regardless of the value of `DEFAULT_THEME`.
2019-01-09 12:22:57 -05:00
THEMES = gitea,arc-green
2020-04-28 14:05:39 -04:00
;All available reactions users can choose on issues/prs and comments.
;Values can be emoji alias (:smile:) or a unicode emoji.
;For custom reactions, add a tightly cropped square image to public/emoji/img/reaction_name.png
2019-12-01 17:57:24 -05:00
REACTIONS = +1, -1, laugh, hooray, confused, heart, rocket, eyes
2019-05-08 04:41:35 -04:00
; Whether the full name of the users should be shown where possible. If the full name isn't set, the username will be used.
DEFAULT_SHOW_FULL_NAME = false
2019-08-25 13:06:36 -04:00
; Whether to search within description at repository search on explore page.
SEARCH_REPO_DESCRIPTION = true
2019-11-21 15:06:23 -05:00
; Whether to enable a Service Worker to cache frontend assets
USE_SERVICE_WORKER = true
2015-07-24 14:52:25 -04:00
2015-09-11 20:42:26 -04:00
[ui.admin]
2018-05-10 21:43:46 -04:00
; Number of users that are displayed on one page
2015-09-11 20:42:26 -04:00
USER_PAGING_NUM = 50
2018-05-10 21:43:46 -04:00
; Number of repos that are displayed on one page
2015-09-25 18:38:43 -04:00
REPO_PAGING_NUM = 50
2018-10-05 05:06:47 -04:00
; Number of notices that are displayed on one page
2015-12-05 01:09:14 -05:00
NOTICE_PAGING_NUM = 25
2018-05-10 21:43:46 -04:00
; Number of organizations that are displayed on one page
2015-09-25 13:54:52 -04:00
ORG_PAGING_NUM = 50
2015-09-11 20:42:26 -04:00
2016-07-23 12:23:54 -04:00
[ui.user]
2018-05-10 21:43:46 -04:00
; Number of repos that are displayed on one page
2016-07-23 12:23:54 -04:00
REPO_PAGING_NUM = 15
2017-03-31 21:03:01 -04:00
[ui.meta]
AUTHOR = Gitea - Git with a cup of tea
DESCRIPTION = Gitea (Git with a cup of tea) is a painless self-hosted Git service written in Go
KEYWORDS = go,git,self-hosted,gitea
2020-04-23 23:57:38 -04:00
[ui.notification]
2020-05-07 17:49:00 -04:00
; Control how often the notification endpoint is polled to update the notification
2020-04-23 23:57:38 -04:00
; The timeout will increase to MAX_TIMEOUT in TIMEOUT_STEPs if the notification count is unchanged
; Set MIN_TIMEOUT to 0 to turn off
MIN_TIMEOUT = 10s
MAX_TIMEOUT = 60s
TIMEOUT_STEP = 10s
2020-05-07 17:49:00 -04:00
; This setting determines how often the db is queried to get the latest notification counts.
2020-07-03 05:55:36 -04:00
; If the browser client supports EventSource and SharedWorker, a SharedWorker will be used in preference to polling notification. Set to -1 to disable the EventSource
2020-05-07 17:49:00 -04:00
EVENT_SOURCE_UPDATE_TIME = 10s
2020-04-23 23:57:38 -04:00
2021-01-12 22:45:19 -05:00
[ui.svg]
; Whether to render SVG files as images. If SVG rendering is disabled, SVG files are displayed as text and cannot be embedded in markdown files as images.
ENABLE_RENDER = true
2015-09-01 08:32:02 -04:00
[markdown]
2020-04-21 18:13:56 -04:00
; Render soft line breaks as hard line breaks, which means a single newline character between
; paragraphs will cause a line break and adding trailing whitespace to paragraphs is not
; necessary to force a line break.
2020-05-24 04:14:26 -04:00
; Render soft line breaks as hard line breaks for comments
ENABLE_HARD_LINE_BREAK_IN_COMMENTS = true
; Render soft line breaks as hard line breaks for markdown documents
ENABLE_HARD_LINE_BREAK_IN_DOCUMENTS = false
2019-10-15 03:14:58 -04:00
; Comma separated list of custom URL-Schemes that are allowed as links when rendering Markdown
; for example git,magnet,ftp (more at https://en.wikipedia.org/wiki/List_of_URI_schemes)
; URLs starting with http and https are always displayed, whatever is put in this entry.
2016-01-26 20:05:53 -05:00
CUSTOM_URL_SCHEMES =
2016-08-11 08:48:08 -04:00
; List of file extensions that should be rendered/edited as Markdown
2018-05-10 21:43:46 -04:00
; Separate the extensions with a comma. To render files without any extension as markdown, just put a comma
2016-08-12 05:29:29 -04:00
FILE_EXTENSIONS = .md,.markdown,.mdown,.mkd
2015-09-01 08:32:02 -04:00
2014-02-12 14:54:09 -05:00
[server]
2018-05-10 21:43:46 -04:00
; The protocol the server listens on. One of 'http', 'https', 'unix' or 'fcgi'.
2014-04-05 03:17:57 -04:00
PROTOCOL = http
2014-03-19 07:21:23 -04:00
DOMAIN = localhost
2014-05-01 18:53:41 -04:00
ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
2020-02-23 09:34:53 -05:00
; when STATIC_URL_PREFIX is empty it will follow ROOT_URL
2019-11-14 17:39:48 -05:00
STATIC_URL_PREFIX =
2018-05-10 21:43:46 -04:00
; The address to listen on. Either a IPv4/IPv6 address or the path to a unix socket.
2016-07-02 06:54:48 -04:00
HTTP_ADDR = 0.0.0.0
2020-04-11 11:59:29 -04:00
; The port to listen on. Leave empty when using a unix socket.
2014-05-01 18:53:41 -04:00
HTTP_PORT = 3000
2017-12-25 17:23:43 -05:00
; If REDIRECT_OTHER_PORT is true, and PROTOCOL is set to https an http server
2018-05-10 21:43:46 -04:00
; will be started on PORT_TO_REDIRECT and it will redirect plain, non-secure http requests to the main
2017-12-25 17:23:43 -05:00
; ROOT_URL. Defaults are false for REDIRECT_OTHER_PORT and 80 for
; PORT_TO_REDIRECT.
REDIRECT_OTHER_PORT = false
PORT_TO_REDIRECT = 80
2016-08-11 17:46:33 -04:00
; Permission for unix socket
UNIX_SOCKET_PERMISSION = 666
2016-11-07 08:26:13 -05:00
; Local (DMZ) URL for Gitea workers (such as SSH update) accessing web service.
2015-12-09 15:36:43 -05:00
; 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.
2018-05-21 21:35:36 -04:00
; Do not set this variable if PROTOCOL is set to 'unix'.
2016-07-02 06:54:48 -04:00
LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/
2015-02-07 10:46:57 -05:00
; Disable SSH feature when not available
DISABLE_SSH = false
2018-05-10 21:43:46 -04:00
; Whether to use the builtin SSH server or not.
2015-11-08 16:59:56 -05:00
START_SSH_SERVER = false
2018-05-10 21:43:46 -04:00
; Username to use for the builtin SSH server. If blank, then it is the value of RUN_USER.
2017-10-14 11:51:00 -04:00
BUILTIN_SSH_SERVER_USER =
2016-02-25 00:21:48 -05:00
; Domain name to be exposed in clone URL
SSH_DOMAIN = %(DOMAIN)s
2018-11-08 10:16:07 -05:00
; The network interface the builtin SSH server should listen on
2016-12-27 10:02:24 -05:00
SSH_LISTEN_HOST =
2016-02-25 00:21:48 -05:00
; Port number to be exposed in clone URL
2014-05-11 11:18:10 -04:00
SSH_PORT = 22
2018-05-10 21:43:46 -04:00
; The port number the builtin SSH server should listen on
2016-02-25 00:21:48 -05:00
SSH_LISTEN_PORT = %(SSH_PORT)s
; Root path of SSH directory, default is '~/.ssh', but you have to use '/home/git/.ssh'.
2016-06-29 11:11:00 -04:00
SSH_ROOT_PATH =
2018-11-01 09:41:07 -04:00
; Gitea will create a authorized_keys file by default when it is not using the internal ssh server
; If you intend to use the AuthorizedKeysCommand functionality then you should turn this off.
SSH_CREATE_AUTHORIZED_KEYS_FILE = true
2020-10-10 20:38:09 -04:00
; Gitea will create a authorized_principals file by default when it is not using the internal ssh server
; If you intend to use the AuthorizedPrincipalsCommand functionality then you should turn this off.
SSH_CREATE_AUTHORIZED_PRINCIPALS_FILE = true
2018-05-10 21:43:46 -04:00
; For the built-in SSH server, choose the ciphers to support for SSH connections,
2017-10-21 09:13:41 -04:00
; for system SSH this setting has no effect
SSH_SERVER_CIPHERS = aes128-ctr, aes192-ctr, aes256-ctr, aes128-gcm@openssh.com, arcfour256, arcfour128
2018-05-10 21:43:46 -04:00
; For the built-in SSH server, choose the key exchange algorithms to support for SSH connections,
2017-11-02 11:26:41 -04:00
; for system SSH this setting has no effect
SSH_SERVER_KEY_EXCHANGES = diffie-hellman-group1-sha1, diffie-hellman-group14-sha1, ecdh-sha2-nistp256, ecdh-sha2-nistp384, ecdh-sha2-nistp521, curve25519-sha256@libssh.org
2018-05-10 21:43:46 -04:00
; For the built-in SSH server, choose the MACs to support for SSH connections,
2017-11-02 11:26:41 -04:00
; for system SSH this setting has no effect
SSH_SERVER_MACS = hmac-sha2-256-etm@openssh.com, hmac-sha2-256, hmac-sha1, hmac-sha1-96
2018-05-10 21:43:46 -04:00
; Directory to create temporary files in when testing public keys using ssh-keygen,
; default is the system temporary directory.
2016-02-27 20:48:39 -05:00
SSH_KEY_TEST_PATH =
2018-05-10 21:43:46 -04:00
; Path to ssh-keygen, default is 'ssh-keygen' which means the shell is responsible for finding out which one to call.
2016-02-27 20:48:39 -05:00
SSH_KEYGEN_PATH = ssh-keygen
2017-06-27 21:35:35 -04:00
; Enable SSH Authorized Key Backup when rewriting all keys, default is true
2020-10-10 20:38:09 -04:00
SSH_AUTHORIZED_KEYS_BACKUP = true
; Determines which principals to allow
; - empty: if SSH_TRUSTED_USER_CA_KEYS is empty this will default to off, otherwise will default to email, username.
; - off: Do not allow authorized principals
; - email: the principal must match the user's email
; - username: the principal must match the user's username
; - anything: there will be no checking on the content of the principal
SSH_AUTHORIZED_PRINCIPALS_ALLOW = email, username
; Enable SSH Authorized Principals Backup when rewriting all keys, default is true
SSH_AUTHORIZED_PRINCIPALS_BACKUP = true
; Specifies the public keys of certificate authorities that are trusted to sign user certificates for authentication.
; Multiple keys should be comma separated.
; E.g."ssh-<algorithm> <key>". or "ssh-<algorithm> <key1>, ssh-<algorithm> <key2>".
; For more information see "TrustedUserCAKeys" in the sshd config manpages.
SSH_TRUSTED_USER_CA_KEYS =
; Absolute path of the `TrustedUserCaKeys` file gitea will manage.
; Default this `RUN_USER`/.ssh/gitea-trusted-user-ca-keys.pem
; If you're running your own ssh server and you want to use the gitea managed file you'll also need to modify your
; sshd_config to point to this file. The official docker image will automatically work without further configuration.
SSH_TRUSTED_USER_CA_KEYS_FILENAME =
2017-07-15 10:21:51 -04:00
; Enable exposure of SSH clone URL to anonymous visitors, default is false
SSH_EXPOSE_ANONYMOUS = false
2016-02-27 20:48:39 -05:00
; Indicate whether to check minimum key size with corresponding type
MINIMUM_KEY_SIZE_CHECK = false
2014-04-27 03:05:13 -04:00
; Disable CDN even in "prod" mode
OFFLINE_MODE = false
2014-05-06 13:47:47 -04:00
DISABLE_ROUTER_LOG = false
2014-04-20 20:52:00 -04:00
; Generate steps:
2016-11-07 08:53:29 -05:00
; $ ./gitea cert -ca=true -duration=8760h0m0s -host=myhost.example.com
2014-11-27 16:42:06 -05:00
;
; Or from a .pfx file exported from the Windows certificate store (do
; not forget to export the private key):
; $ openssl pkcs12 -in cert.pfx -out cert.pem -nokeys
; $ openssl pkcs12 -in cert.pfx -out key.pem -nocerts -nodes
2020-01-19 14:07:44 -05:00
; Paths are relative to CUSTOM_PATH
CERT_FILE = https/cert.pem
KEY_FILE = https/key.pem
2018-05-10 21:43:46 -04:00
; Root directory containing templates and static files.
2016-11-07 08:26:13 -05:00
; default is the path where Gitea is executed
2014-08-30 09:12:53 -04:00
STATIC_ROOT_PATH =
2016-03-09 21:16:43 -05:00
; Default path for App data
APP_DATA_PATH = data
2020-12-23 23:25:17 -05:00
; Enable gzip compression for runtime-generated content, static resources excluded
2014-10-13 18:04:07 -04:00
ENABLE_GZIP = false
2018-08-07 14:49:18 -04:00
; Application profiling (memory and cpu)
; For "web" command it listens on localhost:6060
; For "serve" command it dumps to disk at PPROF_DATA_PATH as (cpuprofile|memprofile)_<username>_<temporary id>
ENABLE_PPROF = false
; PPROF_DATA_PATH, use an absolute path when you start gitea as service
PPROF_DATA_PATH = data/tmp/pprof
2020-01-06 11:50:44 -05:00
; Landing page, can be "home", "explore", "organizations" or "login"
; The "login" choice is not a security measure but just a UI flow change, use REQUIRE_SIGNIN_VIEW to force users to log in.
2014-11-24 18:47:59 -05:00
LANDING_PAGE = home
2017-06-23 04:39:17 -04:00
; Enables git-lfs support. true or false, default is false.
LFS_START_SERVER = false
2018-05-10 21:43:46 -04:00
; Where your lfs files reside, default is data/lfs.
2017-06-23 04:39:17 -04:00
LFS_CONTENT_PATH = data/lfs
2018-05-10 21:43:46 -04:00
; LFS authentication secret, change this yourself
2017-12-13 17:22:59 -05:00
LFS_JWT_SECRET =
2018-05-29 04:07:16 -04:00
; LFS authentication validity period (in time.Duration), pushes taking longer than this may fail.
LFS_HTTP_AUTH_EXPIRY = 20m
2020-02-27 23:46:57 -05:00
; Maximum allowed LFS file size in bytes (Set to 0 for no limit).
LFS_MAX_FILE_SIZE = 0
2020-03-09 15:56:18 -04:00
; Maximum number of locks returned per page
LFS_LOCKS_PAGING_NUM = 50
2019-10-15 09:39:51 -04:00
; Allow graceful restarts using SIGHUP to fork
ALLOW_GRACEFUL_RESTARTS = true
; After a restart the parent will finish ongoing requests before
; shutting down. Force shutdown if this process takes longer than this delay.
; set to a negative value to disable
GRACEFUL_HAMMER_TIME = 60s
2019-11-21 13:32:02 -05:00
; Allows the setting of a startup timeout and waithint for Windows as SVC service
; 0 disables this.
STARTUP_TIMEOUT = 0
2020-11-17 17:44:52 -05:00
; Static resources, includes resources on custom/, public/ and all uploaded avatars web browser cache time. Note that this cache is disabled when RUN_MODE is "dev". Default is 6h
2019-10-14 18:05:57 -04:00
STATIC_CACHE_TIME = 6h
2014-02-18 17:48:02 -05:00
2016-02-27 20:48:39 -05:00
; Define allowed algorithms and their minimum key length (use -1 to disable a type)
[ssh.minimum_key_sizes]
ED25519 = 256
2017-12-13 17:22:59 -05:00
ECDSA = 256
RSA = 2048
2020-10-09 02:52:57 -04:00
DSA = -1 ; set to 1024 to switch on
2016-02-27 20:48:39 -05:00
2014-02-18 17:48:02 -05:00
[database]
2020-04-11 11:59:29 -04:00
; Database to use. Either "mysql", "postgres", "mssql" or "sqlite3".
2014-02-18 17:48:02 -05:00
DB_TYPE = mysql
2014-03-29 01:40:22 -04:00
HOST = 127.0.0.1:3306
2016-11-07 08:26:13 -05:00
NAME = gitea
2014-02-18 17:48:02 -05:00
USER = root
2018-01-27 13:35:49 -05:00
; Use PASSWD = `your password` for quoting if you use special characters in the password.
2014-03-10 04:55:53 -04:00
PASSWD =
2020-01-20 10:45:14 -05:00
; For Postgres, schema to use if different from "public". The schema must exist beforehand,
; the user must have creation privileges on it, and the user search path must be set
; to the look into the schema first. e.g.:ALTER USER user SET SEARCH_PATH = schema_name,"$user",public;
SCHEMA =
2018-08-23 18:42:02 -04:00
; For Postgres, either "disable" (default), "require", or "verify-full"
; For MySQL, either "false" (default), "true", or "skip-verify"
2014-03-17 14:03:58 -04:00
SSL_MODE = disable
2020-06-18 15:36:59 -04:00
; For MySQL only, either "utf8" or "utf8mb4", default is "utf8mb4".
2019-05-24 00:15:26 -04:00
; NOTICE: for "utf8mb4" you must use MySQL InnoDB > 5.6. Gitea is unable to check this.
2020-06-18 15:36:59 -04:00
CHARSET = utf8mb4
2018-08-07 14:49:18 -04:00
; For "sqlite3" and "tidb", use an absolute path when you start gitea as service
2016-11-07 08:26:13 -05:00
PATH = data/gitea.db
2017-06-14 22:51:17 -04:00
; For "sqlite3" only. Query timeout
SQLITE_TIMEOUT = 500
2017-10-21 02:26:23 -04:00
; For iterate buffer, default is 50
ITERATE_BUFFER_SIZE = 50
2018-03-30 10:49:46 -04:00
; Show the database generated SQL
LOG_SQL = true
2019-01-19 16:17:08 -05:00
; Maximum number of DB Connect retries
DB_RETRIES = 10
; Backoff time per DB retry (time.Duration)
DB_RETRY_BACKOFF = 3s
2019-10-21 17:20:47 -04:00
; Max idle database connections on connnection pool, default is 2
MAX_IDLE_CONNS = 2
; Database connection max life time, default is 0 or 3s mysql (See #6804 & #7071 for reasoning)
2019-08-24 05:24:45 -04:00
CONN_MAX_LIFETIME = 3s
2019-10-21 17:20:47 -04:00
; Database maximum number of open connections, default is 0 meaning no maximum
MAX_OPEN_CONNS = 0
2019-01-19 16:17:08 -05:00
2017-01-24 21:43:02 -05:00
[indexer]
2020-02-13 01:06:17 -05:00
; Issue indexer type, currently support: bleve, db or elasticsearch, default is bleve
2019-02-21 00:01:28 -05:00
ISSUE_INDEXER_TYPE = bleve
2020-02-13 01:06:17 -05:00
; Issue indexer connection string, available when ISSUE_INDEXER_TYPE is elasticsearch
ISSUE_INDEXER_CONN_STR = http://elastic:changeme@localhost:9200
; Issue indexer name, available when ISSUE_INDEXER_TYPE is elasticsearch
ISSUE_INDEXER_NAME = gitea_issues
2019-02-21 00:01:28 -05:00
; Issue indexer storage path, available when ISSUE_INDEXER_TYPE is bleve
2017-01-24 21:43:02 -05:00
ISSUE_INDEXER_PATH = indexers/issues.bleve
2019-07-17 12:23:54 -04:00
; Issue indexer queue, currently support: channel, levelqueue or redis, default is levelqueue
2019-02-21 00:01:28 -05:00
ISSUE_INDEXER_QUEUE_TYPE = levelqueue
2021-01-12 19:49:52 -05:00
; When ISSUE_INDEXER_QUEUE_TYPE is levelqueue, this will be the path where the queue will be saved.
; This can be overriden by `ISSUE_INDEXER_QUEUE_CONN_STR`.
2019-02-21 00:01:28 -05:00
; default is indexers/issues.queue
ISSUE_INDEXER_QUEUE_DIR = indexers/issues.queue
2019-04-08 05:05:15 -04:00
; When `ISSUE_INDEXER_QUEUE_TYPE` is `redis`, this will store the redis connection string.
2021-01-12 19:49:52 -05:00
; When `ISSUE_INDEXER_QUEUE_TYPE` is `levelqueue`, this is a directory or additional options of
; the form `leveldb://path/to/db?option=value&....`, and overrides `ISSUE_INDEXER_QUEUE_DIR`.
2019-04-08 05:05:15 -04:00
ISSUE_INDEXER_QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"
2019-02-21 00:01:28 -05:00
; Batch queue number, default is 20
ISSUE_INDEXER_QUEUE_BATCH_NUMBER = 20
2019-10-15 09:39:51 -04:00
; Timeout the indexer if it takes longer than this to start.
; Set to zero to disable timeout.
2020-11-28 01:12:22 -05:00
STARTUP_TIMEOUT = 30s
2019-02-21 00:01:28 -05:00
2017-10-27 02:10:54 -04:00
; repo indexer by default disabled, since it uses a lot of disk space
REPO_INDEXER_ENABLED = false
2020-08-30 12:08:01 -04:00
; Code search engine type, could be `bleve` or `elasticsearch`.
REPO_INDEXER_TYPE = bleve
; Index file used for code search.
2017-10-27 02:10:54 -04:00
REPO_INDEXER_PATH = indexers/repos.bleve
2020-08-30 12:08:01 -04:00
; Code indexer connection string, available when `REPO_INDEXER_TYPE` is elasticsearch. i.e. http://elastic:changeme@localhost:9200
2020-09-08 18:06:39 -04:00
REPO_INDEXER_CONN_STR =
2020-08-30 12:08:01 -04:00
; Code indexer name, available when `REPO_INDEXER_TYPE` is elasticsearch
REPO_INDEXER_NAME = gitea_codes
2017-01-24 21:43:02 -05:00
UPDATE_BUFFER_LEN = 20
2017-10-27 02:10:54 -04:00
MAX_FILE_SIZE = 1048576
2019-09-11 13:26:28 -04:00
; A comma separated list of glob patterns (see https://github.com/gobwas/glob) to include
; in the index; default is empty
REPO_INDEXER_INCLUDE =
; A comma separated list of glob patterns to exclude from the index; ; default is empty
REPO_INDEXER_EXCLUDE =
2017-01-24 21:43:02 -05:00
2020-01-07 06:23:09 -05:00
[queue]
; Specific queues can be individually configured with [queue.name]. [queue] provides defaults
;
; General queue queue type, currently support: persistable-channel, channel, level, redis, dummy
; default to persistable-channel
TYPE = persistable-channel
; data-dir for storing persistable queues and level queues, individual queues will be named by their type
DATADIR = queues/
; Default queue length before a channel queue will block
LENGTH = 20
; Batch size to send for batched queues
BATCH_LENGTH = 20
; Connection string for redis queues this will store the redis connection string.
2021-01-12 19:49:52 -05:00
; When `TYPE` is `persistable-channel`, this provides a directory for the underlying leveldb
; or additional options of the form `leveldb://path/to/db?option=value&....`, and will override `DATADIR`.
2020-01-07 06:23:09 -05:00
CONN_STR = "addrs=127.0.0.1:6379 db=0"
2020-09-27 17:09:46 -04:00
; Provides the suffix of the default redis/disk queue name - specific queues can be overriden within in their [queue.name] sections.
2020-01-07 06:23:09 -05:00
QUEUE_NAME = "_queue"
2020-09-27 17:09:46 -04:00
; Provides the suffix of the default redis/disk unique queue set name - specific queues can be overriden within in their [queue.name] sections.
SET_NAME = "_unique"
2020-01-07 06:23:09 -05:00
; If the queue cannot be created at startup - level queues may need a timeout at startup - wrap the queue:
WRAP_IF_NECESSARY = true
; Attempt to create the wrapped queue at max
MAX_ATTEMPTS = 10
; Timeout queue creation
TIMEOUT = 15m30s
; Create a pool with this many workers
WORKERS = 1
; Dynamically scale the worker pool to at this many workers
MAX_WORKERS = 10
; Add boost workers when the queue blocks for BLOCK_TIMEOUT
BLOCK_TIMEOUT = 1s
; Remove the boost workers after BOOST_TIMEOUT
BOOST_TIMEOUT = 5m
; During a boost add BOOST_WORKERS
BOOST_WORKERS = 5
2014-03-21 01:09:22 -04:00
[admin]
2018-05-10 21:43:46 -04:00
; Disallow regular (non-admin) users from creating organizations.
2017-02-14 07:16:00 -05:00
DISABLE_REGULAR_ORG_CREATION = false
2019-08-29 10:05:42 -04:00
; Default configuration for email notifications for users (user configurable). Options: enabled, onmention, disabled
DEFAULT_EMAIL_NOTIFICATIONS = enabled
2014-03-06 11:10:35 -05:00
[security]
2017-01-01 23:32:21 -05:00
; Whether the installer is disabled
2014-03-31 10:12:36 -04:00
INSTALL_LOCK = false
2014-03-18 01:33:53 -04:00
; !!CHANGE THIS TO KEEP YOUR USER DATA SAFE!!
2014-03-19 07:21:23 -04:00
SECRET_KEY = !#@FDEWREWR&*(
2019-08-13 23:28:11 -04:00
; How long to remember that a user is logged in before requiring relogin (in days)
2014-03-22 16:40:09 -04:00
LOGIN_REMEMBER_DAYS = 7
2016-11-07 08:26:13 -05:00
COOKIE_USERNAME = gitea_awesome
COOKIE_REMEMBER_NAME = gitea_incredible
2014-06-24 13:55:47 -04:00
; Reverse proxy authentication header name of user name
REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER
2018-12-18 12:05:48 -05:00
REVERSE_PROXY_AUTHENTICATION_EMAIL = X-WEBAUTH-EMAIL
2018-05-10 21:43:46 -04:00
; The minimum password length for new Users
2016-12-24 08:40:44 -05:00
MIN_PASSWORD_LENGTH = 6
2018-11-04 21:21:56 -05:00
; Set to true to allow users to import local server paths
2017-01-22 20:19:50 -05:00
IMPORT_LOCAL_PATHS = false
2020-10-07 05:55:13 -04:00
; Set to false to allow users with git hook privileges to create custom git hooks.
; Custom git hooks can be used to perform arbitrary code execution on the host operating system.
; This enables the users to access and modify this config file and the Gitea database and interrupt the Gitea service.
; By modifying the Gitea database, users can gain Gitea administrator privileges.
; It also enables them to access other resources available to the user on the operating system that is running the Gitea instance and perform arbitrary actions in the name of the Gitea OS user.
; WARNING: This maybe harmful to you website or your operating system.
DISABLE_GIT_HOOKS = true
2021-02-11 12:34:34 -05:00
; Set to true to disable webhooks feature.
DISABLE_WEBHOOKS = false
2019-11-14 17:39:48 -05:00
; Set to false to allow pushes to gitea repositories despite having an incomplete environment - NOT RECOMMENDED
ONLY_ALLOW_PUSH_IF_GITEA_ENVIRONMENT_SET = true
2019-10-14 11:24:26 -04:00
;Comma separated list of character classes required to pass minimum complexity.
2020-08-21 18:42:23 -04:00
;If left empty or no valid values are specified, the default is off (no checking)
;Classes include "lower,upper,digit,spec"
PASSWORD_COMPLEXITY = off
2020-09-03 14:58:31 -04:00
; Password Hash algorithm, either "argon2", "pbkdf2", "scrypt" or "bcrypt"
PASSWORD_HASH_ALGO = argon2
2019-07-12 09:57:31 -04:00
; Set false to allow JavaScript to read CSRF cookie
CSRF_COOKIE_HTTP_ONLY = true
2020-09-08 18:06:39 -04:00
; Validate against https://haveibeenpwned.com/Passwords to see if a password has been exposed
PASSWORD_CHECK_PWN = false
2014-03-19 07:21:23 -04:00
2017-03-17 10:16:08 -04:00
[openid]
;
2018-05-10 21:43:46 -04:00
; OpenID is an open, standard and decentralized authentication protocol.
2017-03-17 10:16:08 -04:00
; Your identity is the address of a webpage you provide, which describes
; how to prove you are in control of that page.
;
; For more info: https://en.wikipedia.org/wiki/OpenID
;
; Current implementation supports OpenID-2.0
;
; Tested to work providers at the time of writing:
; - Any GNUSocial node (your.hostname.tld/username)
; - Any SimpleID provider (http://simpleid.koinic.net)
; - http://openid.org.cn/
; - openid.stackexchange.com
; - login.launchpad.net
2017-03-17 12:15:01 -04:00
; - <username>.livejournal.com
2017-03-17 10:16:08 -04:00
;
; Whether to allow signin in via OpenID
ENABLE_OPENID_SIGNIN = true
; Whether to allow registering via OpenID
2018-05-10 21:43:46 -04:00
; Do not include to rely on rhw DISABLE_REGISTRATION setting
2017-03-29 06:57:43 -04:00
;ENABLE_OPENID_SIGNUP = true
2017-03-17 10:16:08 -04:00
; Allowed URI patterns (POSIX regexp).
; Space separated.
; Only these would be allowed if non-blank.
; Example value: trusted.domain.org trusted.domain.net
WHITELISTED_URIS =
; Forbidden URI patterns (POSIX regexp).
2017-10-17 22:11:23 -04:00
; Space separated.
2017-03-17 10:16:08 -04:00
; Only used if WHITELISTED_URIS is blank.
; Example value: loadaverage.org/badguy stackexchange.com/.*spammer
BLACKLISTED_URIS =
2014-03-19 07:21:23 -04:00
[service]
2017-05-29 03:35:47 -04:00
; Time limit to confirm account/email registration
2014-03-19 07:21:23 -04:00
ACTIVE_CODE_LIVE_MINUTES = 180
2018-05-10 21:43:46 -04:00
; Time limit to perform the reset of a forgotten password
2014-03-19 07:21:23 -04:00
RESET_PASSWD_CODE_LIVE_MINUTES = 180
2018-05-10 21:43:46 -04:00
; Whether a new user needs to confirm their email when registering.
2014-03-19 08:27:27 -04:00
REGISTER_EMAIL_CONFIRM = false
2020-12-19 20:31:06 -05:00
; Whether a new user needs to be confirmed manually after registration. (Requires `REGISTER_EMAIL_CONFIRM` to be disabled.)
REGISTER_MANUAL_CONFIRM = false
2018-11-14 20:00:04 -05:00
; List of domain names that are allowed to be used to register on a Gitea instance
; gitea.io,example.com
2020-11-28 01:12:22 -05:00
EMAIL_DOMAIN_WHITELIST =
2018-05-10 21:43:46 -04:00
; Disallow registration, only allow admins to create accounts.
2014-04-21 18:03:04 -04:00
DISABLE_REGISTRATION = false
2018-11-25 11:29:44 -05:00
; Allow registration only using third-party services, it works only when DISABLE_REGISTRATION is false
2018-05-13 03:51:16 -04:00
ALLOW_ONLY_EXTERNAL_REGISTRATION = false
2014-03-21 01:59:15 -04:00
; User must sign in to view anything.
REQUIRE_SIGNIN_VIEW = false
2014-03-23 19:09:11 -04:00
; Mail notification
ENABLE_NOTIFY_MAIL = false
2019-10-19 10:27:15 -04:00
; This setting enables gitea to be signed in with HTTP BASIC Authentication using the user's password
; If you set this to false you will not be able to access the tokens endpoints on the API with your password
; Please note that setting this to false will not disable OAuth Basic or Basic authentication using a token
ENABLE_BASIC_AUTHENTICATION = true
2017-12-29 23:19:38 -05:00
; More detail: https://github.com/gogits/gogs/issues/165
2014-06-21 00:51:41 -04:00
ENABLE_REVERSE_PROXY_AUTHENTICATION = false
2015-03-12 13:25:28 -04:00
ENABLE_REVERSE_PROXY_AUTO_REGISTRATION = false
2018-12-18 12:05:48 -05:00
ENABLE_REVERSE_PROXY_EMAIL = false
2015-09-13 11:07:21 -04:00
; Enable captcha validation for registration
2018-07-05 00:13:05 -04:00
ENABLE_CAPTCHA = false
2020-10-02 23:37:53 -04:00
; Type of captcha you want to use. Options: image, recaptcha, hcaptcha
2018-07-05 00:13:05 -04:00
CAPTCHA_TYPE = image
; Enable recaptcha to use Google's recaptcha service
; Go to https://www.google.com/recaptcha/admin to sign up for a key
2020-11-28 01:12:22 -05:00
RECAPTCHA_SECRET =
2018-11-25 11:29:44 -05:00
RECAPTCHA_SITEKEY =
2020-10-02 23:37:53 -04:00
; For hCaptcha, create an account at https://accounts.hcaptcha.com/login to get your keys
HCAPTCHA_SECRET =
HCAPTCHA_SITEKEY =
2019-05-02 09:09:39 -04:00
; Change this to use recaptcha.net or other recaptcha service
RECAPTCHA_URL = https://www.google.com/recaptcha/
2017-01-07 22:12:03 -05:00
; Default value for KeepEmailPrivate
2018-05-10 21:43:46 -04:00
; Each new user will get the value of this setting copied into their profile
2017-01-07 22:12:03 -05:00
DEFAULT_KEEP_EMAIL_PRIVATE = false
2017-05-08 15:51:53 -04:00
; Default value for AllowCreateOrganization
2018-05-10 21:43:46 -04:00
; Every new user will have rights set to create organizations depending on this setting
2017-05-08 15:51:53 -04:00
DEFAULT_ALLOW_CREATE_ORGANIZATION = true
2019-02-18 11:00:27 -05:00
; Either "public", "limited" or "private", default is "public"
; Limited is for signed user only
; Private is only for member of the organization
; Public is for everyone
DEFAULT_ORG_VISIBILITY = public
2019-08-24 08:28:59 -04:00
; Default value for DefaultOrgMemberVisible
2019-10-14 11:24:26 -04:00
; True will make the membership of the users visible when added to the organisation
2019-08-24 08:28:59 -04:00
DEFAULT_ORG_MEMBER_VISIBLE = false
2018-07-17 17:23:58 -04:00
; Default value for EnableDependencies
2018-11-25 11:29:44 -05:00
; Repositories will use dependencies by default depending on this setting
2018-07-17 17:23:58 -04:00
DEFAULT_ENABLE_DEPENDENCIES = true
Allow cross-repository dependencies on issues (#7901)
* in progress changes for #7405, added ability to add cross-repo dependencies
* removed unused repolink var
* fixed query that was breaking ci tests; fixed check in issue dependency add so that the id of the issue and dependency is checked rather than the indexes
* reverted removal of string in local files becasue these are done via crowdin, not updated manually
* removed 'Select("issue.*")' from getBlockedByDependencies and getBlockingDependencies based on comments in PR review
* changed getBlockedByDependencies and getBlockingDependencies to use a more xorm-like query, also updated the sidebar as a result
* simplified the getBlockingDependencies and getBlockedByDependencies methods; changed the sidebar to show the dependencies in a different format where you can see the name of the repository
* made some changes to the issue view in the dependencies (issue name on top, repo full name on separate line). Change view of issue in the dependency search results (also showing the full repo name on separate line)
* replace call to FindUserAccessibleRepoIDs with SearchRepositoryByName. The former was hardcoded to use isPrivate = false on the repo search, but this code needed it to be true. The SearchRepositoryByName method is used more in the code including on the user's dashboard
* some more tweaks to the layout of the issues when showing dependencies and in the search box when you add new dependencies
* added Name to the RepositoryMeta struct
* updated swagger doc
* fixed total count for link header on SearchIssues
* fixed indentation
* fixed aligment of remove icon on dependencies in issue sidebar
* removed unnecessary nil check (unnecessary because issue.loadRepo is called prior to this block)
* reverting .css change, somehow missed or forgot that less is used
* updated less file and generated css; updated sidebar template with styles to line up delete and issue index
* added ordering to the blocked by/depends on queries
* fixed sorting in issue dependency search and the depends on/blocks views to show issues from the current repo first, then by created date descending; added a "all cross repository dependencies" setting to allow this feature to be turned off, if turned off, the issue dependency search will work the way it did before (restricted to the current repository)
* re-applied my swagger changes after merge
* fixed split string condition in issue search
* changed ALLOW_CROSS_REPOSITORY_DEPENDENCIES description to sound more global than just the issue dependency search; returning 400 in the cross repo issue search api method if not enabled; fixed bug where the issue count did not respect the state parameter
* when adding a dependency to an issue, added a check to make sure the issue and dependency are in the same repo if cross repo dependencies is not enabled
* updated sortIssuesSession call in PullRequests, another commit moved this method from pull.go to pull_list.go so I had to re-apply my change here
* fixed incorrect setting of user id parameter in search repos call
2019-10-31 01:06:10 -04:00
; Dependencies can be added from any repository where the user is granted access or only from the current repository depending on this setting.
ALLOW_CROSS_REPOSITORY_DEPENDENCIES = true
2018-11-20 04:54:09 -05:00
; Enable heatmap on users profiles.
ENABLE_USER_HEATMAP = true
2018-04-09 11:15:32 -04:00
; Enable Timetracking
ENABLE_TIMETRACKING = true
2017-09-12 02:48:13 -04:00
; Default value for EnableTimetracking
; Repositories will use timetracking by default depending on this setting
DEFAULT_ENABLE_TIMETRACKING = true
; Default value for AllowOnlyContributorsToTrackTime
2018-05-10 21:43:46 -04:00
; Only users with write permissions can track time if this is true
2017-09-12 02:48:13 -04:00
DEFAULT_ALLOW_ONLY_CONTRIBUTORS_TO_TRACK_TIME = true
2017-01-07 22:12:03 -05:00
; Default value for the domain part of the user's email address in the git log
2018-05-10 21:43:46 -04:00
; if he has set KeepEmailPrivate to true. The user's email will be replaced with a
2017-01-07 22:12:03 -05:00
; concatenation of the user name in lower case, "@" and NO_REPLY_ADDRESS.
2019-12-13 23:14:43 -05:00
NO_REPLY_ADDRESS = noreply.%(DOMAIN)s
2019-01-19 18:22:47 -05:00
; Show Registration button
SHOW_REGISTRATION_BUTTON = true
2019-12-15 09:20:08 -05:00
; Show milestones dashboard page - a view of all the user's milestones
SHOW_MILESTONES_DASHBOARD_PAGE = true
2019-01-27 04:25:21 -05:00
; Default value for AutoWatchNewRepos
2019-04-02 03:48:31 -04:00
; When adding a repo to a team or creating a new repo all team members will watch the
; repo automatically if enabled
2019-01-27 04:25:21 -05:00
AUTO_WATCH_NEW_REPOS = true
2019-11-10 04:22:19 -05:00
; Default value for AutoWatchOnChanges
; Make the user watch a repository When they commit for the first time
AUTO_WATCH_ON_CHANGES = false
2021-01-21 21:56:19 -05:00
; Minimum amount of time a user must exist before comments are kept when the user is deleted.
USER_DELETE_WITH_COMMENTS_MAX_TIME = 0
2014-03-18 01:33:53 -04:00
2014-06-08 04:45:34 -04:00
[webhook]
2016-08-30 19:18:33 -04:00
; Hook task queue length, increase if webhook shooting starts hanging
2015-07-25 09:32:04 -04:00
QUEUE_LENGTH = 1000
2014-06-08 04:45:34 -04:00
; Deliver timeout in seconds
DELIVER_TIMEOUT = 5
2015-02-10 21:06:59 -05:00
; Allow insecure certification
2015-02-11 12:04:01 -05:00
SKIP_TLS_VERIFY = false
2015-08-27 11:06:14 -04:00
; Number of history information in each page
PAGING_NUM = 10
2019-11-08 16:25:53 -05:00
; Proxy server URL, support http://, https//, socks://, blank will follow environment http_proxy/https_proxy
2019-11-14 17:39:48 -05:00
PROXY_URL =
2019-11-08 16:25:53 -05:00
; Comma separated list of host names requiring proxy. Glob patterns (*) are accepted; use ** to match all hosts.
2019-11-14 17:39:48 -05:00
PROXY_HOSTS =
2014-06-08 04:45:34 -04:00
2014-03-18 01:33:53 -04:00
[mailer]
2014-03-18 04:19:10 -04:00
ENABLED = false
2014-03-19 21:05:48 -04:00
; Buffer length of channel, keep it as it is if you don't know what it is.
2015-09-16 23:08:46 -04:00
SEND_BUFFER_LEN = 100
2019-04-17 00:56:40 -04:00
; Prefix displayed before subject in mail
SUBJECT_PREFIX =
2014-03-18 01:33:53 -04:00
; Mail server
2014-03-19 08:27:27 -04:00
; Gmail: smtp.gmail.com:587
2016-06-29 16:04:15 -04:00
; QQ: smtp.qq.com:465
2020-06-10 14:35:27 -04:00
; Using STARTTLS on port 587 is recommended per RFC 6409.
; Note, if the port ends with "465", SMTPS will be used.
2016-06-29 11:11:00 -04:00
HOST =
2018-05-10 21:43:46 -04:00
; Disable HELO operation when hostnames are different.
2016-06-29 11:11:00 -04:00
DISABLE_HELO =
2018-05-10 21:43:46 -04:00
; Custom hostname for HELO operation, if no value is provided, one is retrieved from system.
2016-06-29 11:11:00 -04:00
HELO_HOSTNAME =
2020-07-21 19:50:25 -04:00
; Whether or not to skip verification of certificates; `true` to disable verification. This option is unsafe. Consider adding the certificate to the system trust store instead.
SKIP_VERIFY = false
2015-02-13 02:33:55 -05:00
; Use client certificate
2015-02-13 03:06:12 -05:00
USE_CERTIFICATE = false
CERT_FILE = custom/mailer/cert.pem
KEY_FILE = custom/mailer/key.pem
2020-05-24 18:56:18 -04:00
; Should SMTP connect with TLS, (if port ends with 465 TLS will always be used.)
; If this is false but STARTTLS is supported the connection will be upgraded to TLS opportunistically.
2018-11-26 14:21:42 -05:00
IS_TLS_ENABLED = false
2016-06-29 11:11:00 -04:00
; Mail from address, RFC 5322. This can be just an email address, or the `"Name" <email@example.com>` format
2014-08-30 09:12:53 -04:00
FROM =
2014-03-18 01:33:53 -04:00
; Mailer user name and password
2020-05-24 18:56:18 -04:00
; Please Note: Authentication is only supported when the SMTP server communication is encrypted with TLS (this can be via STARTTLS) or `HOST=localhost`.
2014-08-30 09:12:53 -04:00
USER =
2018-01-27 13:35:49 -05:00
; Use PASSWD = `your password` for quoting if you use special characters in the password.
2014-08-30 09:12:53 -04:00
PASSWD =
2017-06-06 21:14:31 -04:00
; Send mails as plain text
SEND_AS_PLAIN_TEXT = false
2019-02-02 21:06:52 -05:00
; Set Mailer Type (either SMTP, sendmail or dummy to just send to the log)
MAILER_TYPE = smtp
2017-10-17 22:11:23 -04:00
; Specify an alternative sendmail binary
2016-12-25 08:55:22 -05:00
SENDMAIL_PATH = sendmail
2017-10-25 15:27:25 -04:00
; Specify any extra sendmail arguments
SENDMAIL_ARGS =
2020-05-02 19:04:31 -04:00
; Timeout for Sendmail
SENDMAIL_TIMEOUT = 5m
2014-03-19 03:24:17 -04:00
2014-03-21 09:06:47 -04:00
[cache]
2020-02-01 14:11:32 -05:00
; if the cache enabled
ENABLED = true
2014-03-21 10:09:57 -04:00
; Either "memory", "redis", or "memcache", default is "memory"
2014-03-21 09:06:47 -04:00
ADAPTER = memory
2014-03-21 10:09:57 -04:00
; For "memory" only, GC interval in seconds, default is 60
INTERVAL = 60
; For "redis" and "memcache", connection host address
2015-01-17 02:17:53 -05:00
; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
2014-07-26 00:24:27 -04:00
; memcache: `127.0.0.1:11211`
2014-03-21 10:09:57 -04:00
HOST =
2017-10-25 21:37:33 -04:00
; Time to keep items in cache if not used, default is 16 hours.
; Setting it to 0 disables caching
ITEM_TTL = 16h
2014-03-21 09:06:47 -04:00
2020-02-01 14:11:32 -05:00
; Last commit cache
[cache.last_commit]
; if the cache enabled
ENABLED = true
; Time to keep items in cache if not used, default is 8760 hours.
; Setting it to 0 disables caching
ITEM_TTL = 8760h
; Only enable the cache when repository's commits count great than
COMMITS_COUNT = 1000
2014-03-22 08:49:53 -04:00
[session]
2016-07-02 06:23:15 -04:00
; Either "memory", "file", or "redis", default is "memory"
2014-12-20 22:51:16 -05:00
PROVIDER = memory
2014-03-22 09:21:57 -04:00
; Provider config options
2018-05-10 21:43:46 -04:00
; memory: doesn't have any config yet
2014-07-26 00:24:27 -04:00
; file: session file path, e.g. `data/sessions`
2015-01-17 02:17:53 -05:00
; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
2014-07-26 00:24:27 -04:00
; mysql: go-sql-driver/mysql dsn config string, e.g. `root:password@/session_table`
2014-03-22 08:49:53 -04:00
PROVIDER_CONFIG = data/sessions
2014-03-22 09:21:57 -04:00
; Session cookie name
2016-12-27 10:02:24 -05:00
COOKIE_NAME = i_like_gitea
2014-03-22 09:21:57 -04:00
; If you use session in https only, default is false
2014-03-22 08:49:53 -04:00
COOKIE_SECURE = false
2017-03-17 23:10:30 -04:00
; Session GC time interval in seconds, default is 86400 (1 day)
2014-03-22 08:49:53 -04:00
GC_INTERVAL_TIME = 86400
2017-03-17 23:10:30 -04:00
; Session life time in seconds, default is 86400 (1 day)
2014-03-22 08:49:53 -04:00
SESSION_LIFE_TIME = 86400
2014-03-22 06:42:19 -04:00
[picture]
2014-11-21 10:58:08 -05:00
AVATAR_UPLOAD_PATH = data/avatars
2019-05-29 22:22:26 -04:00
REPOSITORY_AVATAR_UPLOAD_PATH = data/repo-avatars
2019-06-02 02:40:12 -04:00
; How Gitea deals with missing repository avatars
; none = no avatar will be displayed; random = random avatar will be displayed; image = default image will be used
REPOSITORY_AVATAR_FALLBACK = none
REPOSITORY_AVATAR_FALLBACK_IMAGE = /img/repo_default.png
2019-05-29 22:22:26 -04:00
; Max Width and Height of uploaded avatars.
; This is to limit the amount of RAM used when resizing the image.
2018-07-02 23:56:32 -04:00
AVATAR_MAX_WIDTH = 4096
AVATAR_MAX_HEIGHT = 3072
2019-05-29 22:22:26 -04:00
; Maximum alloved file size for uploaded avatars.
; This is to limit the amount of RAM used when resizing the image.
AVATAR_MAX_FILE_SIZE = 1048576
2014-11-16 20:27:04 -05:00
; Chinese users can choose "duoshuo"
2015-08-09 20:44:43 -04:00
; or a custom avatar source, like: http://cn.gravatar.com/avatar/
2014-11-16 20:27:04 -05:00
GRAVATAR_SOURCE = gravatar
2018-05-10 21:43:46 -04:00
; This value will always be true in offline mode.
2014-05-01 21:30:04 -04:00
DISABLE_GRAVATAR = false
2016-08-07 13:27:38 -04:00
; Federated avatar lookup uses DNS to discover avatar associated
2016-08-23 12:50:33 -04:00
; with emails, see https://www.libravatar.org
2018-05-10 21:43:46 -04:00
; This value will always be false in offline mode or when Gravatar is disabled.
2016-08-07 13:27:38 -04:00
ENABLE_FEDERATED_AVATAR = false
2014-03-22 06:42:19 -04:00
2014-07-23 15:15:47 -04:00
[attachment]
2020-10-05 01:49:33 -04:00
; Whether issue and pull request attachments are enabled. Defaults to `true`
2018-05-28 10:56:54 -04:00
ENABLED = true
2020-10-05 01:49:33 -04:00
; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
ALLOWED_TYPES = .docx,.gif,.gz,.jpeg,.jpg,.log,.pdf,.png,.pptx,.txt,.xlsx,.zip
2018-05-10 21:43:46 -04:00
; Max size of each file. Defaults to 4MB
2015-09-02 16:18:09 -04:00
MAX_SIZE = 4
2018-05-10 21:43:46 -04:00
; Max number of files per upload. Defaults to 5
2015-08-11 11:24:40 -04:00
MAX_FILES = 5
2020-08-18 00:23:45 -04:00
; Storage type for attachments, `local` for local disk or `minio` for s3 compatible
; object storage service, default is `local`.
2020-09-29 05:05:13 -04:00
STORAGE_TYPE = local
2020-08-18 00:23:45 -04:00
; Allows the storage driver to redirect to authenticated URLs to serve files directly
; Currently, only `minio` is supported.
SERVE_DIRECT = false
2020-09-29 05:05:13 -04:00
; Path for attachments. Defaults to `data/attachments` only available when STORAGE_TYPE is `local`
2020-08-18 00:23:45 -04:00
PATH = data/attachments
2020-09-29 05:05:13 -04:00
; Minio endpoint to connect only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_ENDPOINT = localhost:9000
2020-09-29 05:05:13 -04:00
; Minio accessKeyID to connect only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_ACCESS_KEY_ID =
2020-09-29 05:05:13 -04:00
; Minio secretAccessKey to connect only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_SECRET_ACCESS_KEY =
2020-09-29 05:05:13 -04:00
; Minio bucket to store the attachments only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_BUCKET = gitea
2020-09-29 05:05:13 -04:00
; Minio location to create bucket only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_LOCATION = us-east-1
2020-09-29 05:05:13 -04:00
; Minio base path on the bucket only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_BASE_PATH = attachments/
2020-09-29 05:05:13 -04:00
; Minio enabled ssl only available when STORAGE_TYPE is `minio`
2020-08-18 00:23:45 -04:00
MINIO_USE_SSL = false
2014-07-23 15:15:47 -04:00
2014-07-24 16:31:59 -04:00
[time]
2017-10-17 22:11:23 -04:00
; Specifies the format for fully outputted dates. Defaults to RFC1123
2014-07-24 16:31:59 -04:00
; Special supported values are ANSIC, UnixDate, RubyDate, RFC822, RFC822Z, RFC850, RFC1123, RFC1123Z, RFC3339, RFC3339Nano, Kitchen, Stamp, StampMilli, StampMicro and StampNano
; For more information about the format see http://golang.org/pkg/time/#pkg-constants
2014-08-30 09:12:53 -04:00
FORMAT =
2019-08-15 10:46:21 -04:00
; Location the UI time display i.e. Asia/Shanghai
; Empty means server's location setting
DEFAULT_UI_LOCATION =
2014-07-24 16:31:59 -04:00
2014-03-19 03:24:17 -04:00
[log]
2014-05-28 01:53:06 -04:00
ROOT_PATH =
2014-03-22 17:59:22 -04:00
; Either "console", "file", "conn", "smtp" or "database", default is "console"
2014-05-11 14:37:12 -04:00
; Use comma to separate multiple modes, e.g. "console, file"
2014-03-19 03:24:17 -04:00
MODE = console
2018-05-10 21:43:46 -04:00
; Buffer length of the channel, keep it as it is if you don't know what it is.
2014-03-19 03:24:17 -04:00
BUFFER_LEN = 10000
2019-04-02 03:48:31 -04:00
; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Info"
ROUTER_LOG_LEVEL = Info
ROUTER = console
ENABLE_ACCESS_LOG = false
2021-01-13 15:30:46 -05:00
ACCESS_LOG_TEMPLATE = {{.Ctx.RemoteAddr}} - {{.Identity}} {{.Start.Format "[02/Jan/2006:15:04:05 -0700]" }} "{{.Ctx.Req.Method}} {{.Ctx.Req.URL.RequestURI}} {{.Ctx.Req.Proto}}" {{.ResponseWriter.Status}} {{.ResponseWriter.Size}} "{{.Ctx.Req.Referer}}\" \"{{.Ctx.Req.UserAgent}}"
2019-04-02 03:48:31 -04:00
ACCESS = file
; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Trace"
LEVEL = Info
; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "None"
STACKTRACE_LEVEL = None
; Generic log modes
[log.x]
FLAGS = stdflags
EXPRESSION =
PREFIX =
COLORIZE = false
2014-03-19 03:24:17 -04:00
2014-03-19 04:08:25 -04:00
; For "console" mode only
2014-03-19 03:24:17 -04:00
[log.console]
2014-08-30 09:12:53 -04:00
LEVEL =
2019-04-02 03:48:31 -04:00
STDERR = false
2014-03-19 03:24:17 -04:00
; For "file" mode only
[log.file]
2014-08-30 09:12:53 -04:00
LEVEL =
2019-04-02 03:48:31 -04:00
; Set the file_name for the logger. If this is a relative path this
; will be relative to ROOT_PATH
FILE_NAME =
2014-03-19 03:24:17 -04:00
; This enables automated log rotate(switch of following options), default is true
2014-03-19 04:08:25 -04:00
LOG_ROTATE = true
2018-05-10 21:43:46 -04:00
; Max size shift of a single file, default is 28 means 1 << 28, 256MB
2014-03-19 04:08:25 -04:00
MAX_SIZE_SHIFT = 28
2014-03-19 03:24:17 -04:00
; Segment log daily, default is true
DAILY_ROTATE = true
2018-05-10 21:43:46 -04:00
; delete the log file after n days, default is 7
2014-03-19 03:24:17 -04:00
MAX_DAYS = 7
2019-04-02 03:48:31 -04:00
; compress logs with gzip
COMPRESS = true
; compression level see godoc for compress/gzip
COMPRESSION_LEVEL = -1
2014-03-19 03:24:17 -04:00
; For "conn" mode only
[log.conn]
2014-08-30 09:12:53 -04:00
LEVEL =
2014-03-19 03:24:17 -04:00
; Reconnect host for every single message, default is false
RECONNECT_ON_MSG = false
; Try to reconnect when connection is lost, default is false
RECONNECT = false
; Either "tcp", "unix" or "udp", default is "tcp"
PROTOCOL = tcp
; Host address
2014-08-30 09:12:53 -04:00
ADDR =
2014-03-19 03:24:17 -04:00
; For "smtp" mode only
[log.smtp]
2014-08-30 09:12:53 -04:00
LEVEL =
2015-12-09 00:32:53 -05:00
; Name displayed in mail title, default is "Diagnostic message from server"
SUBJECT = Diagnostic message from server
2014-03-19 03:24:17 -04:00
; Mail server
2014-08-30 09:12:53 -04:00
HOST =
2014-03-19 03:24:17 -04:00
; Mailer user name and password
2014-08-30 09:12:53 -04:00
USER =
2018-01-27 13:35:49 -05:00
; Use PASSWD = `your password` for quoting if you use special characters in the password.
2014-03-19 03:24:17 -04:00
PASSWD =
2016-12-22 07:27:13 -05:00
; Receivers, can be one or more, e.g. 1@example.com,2@example.com
2014-08-30 09:12:53 -04:00
RECEIVERS =
2014-03-22 17:59:22 -04:00
2015-08-17 14:19:29 -04:00
[cron]
2020-10-22 14:02:28 -04:00
; Enable running all cron tasks periodically with default settings.
ENABLED = false
2016-11-07 08:26:13 -05:00
; Run cron tasks when Gitea starts.
2015-08-17 14:19:29 -04:00
RUN_AT_START = false
2020-10-22 14:02:28 -04:00
; Basic cron tasks - enabled by default
; Clean up old repository archives
[cron.archive_cleanup]
; Whether to enable the job
ENABLED = true
; Whether to always run at least once at start up time (if ENABLED)
RUN_AT_START = true
; Notice if not success
NO_SUCCESS_NOTICE = false
; Time interval for job to run
SCHEDULE = @every 24h
; Archives created more than OLDER_THAN ago are subject to deletion
OLDER_THAN = 24h
2020-09-25 13:37:33 -04:00
2015-08-17 14:19:29 -04:00
; Update mirrors
[cron.update_mirrors]
2016-07-23 08:20:09 -04:00
SCHEDULE = @every 10m
2020-09-25 13:37:33 -04:00
; Enable running Update mirrors task periodically.
ENABLED = true
; Run Update mirrors task when Gitea starts.
RUN_AT_START = false
; Notice if not success
NO_SUCCESS_NOTICE = true
2015-08-17 14:19:29 -04:00
; Repository health check
[cron.repo_health_check]
SCHEDULE = @every 24h
2020-09-25 13:37:33 -04:00
; Enable running Repository health check task periodically.
ENABLED = true
; Run Repository health check task when Gitea starts.
RUN_AT_START = false
; Notice if not success
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2015-12-09 11:38:12 -05:00
TIMEOUT = 60s
2015-12-11 21:23:19 -05:00
; Arguments for command 'git fsck', e.g. "--unreachable --tags"
2018-12-04 17:40:42 -05:00
; see more on http://git-scm.com/docs/git-fsck
2016-06-29 11:11:00 -04:00
ARGS =
2015-08-17 14:19:29 -04:00
; Check repository statistics
[cron.check_repo_stats]
2020-09-25 13:37:33 -04:00
; Enable running check repository statistics task periodically.
ENABLED = true
; Run check repository statistics task when Gitea starts.
2015-08-17 14:19:29 -04:00
RUN_AT_START = true
2020-09-25 13:37:33 -04:00
; Notice if not success
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2015-08-17 14:19:29 -04:00
SCHEDULE = @every 24h
2020-10-22 14:02:28 -04:00
[cron.update_migration_poster_id]
; Update migrated repositories' issues and comments' posterid, it will always attempt synchronization when the instance starts.
2017-12-17 09:37:34 -05:00
ENABLED = true
2020-10-22 14:02:28 -04:00
; Update migrated repositories' issues and comments' posterid when starting server (default true)
2017-02-10 23:00:46 -05:00
RUN_AT_START = true
2020-09-25 13:37:33 -04:00
; Notice if not success
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-10-22 14:02:28 -04:00
; Interval as a duration between each synchronization. (default every 24h)
2017-02-10 23:00:46 -05:00
SCHEDULE = @every 24h
2017-05-10 09:10:18 -04:00
; Synchronize external user data (only LDAP user synchronization is supported)
[cron.sync_external_users]
2020-09-25 13:37:33 -04:00
ENABLED = true
2017-10-17 22:11:23 -04:00
; Synchronize external user data when starting server (default false)
2017-05-10 09:10:18 -04:00
RUN_AT_START = false
2020-09-25 13:37:33 -04:00
; Notice if not success
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2017-05-10 09:10:18 -04:00
; Interval as a duration between each synchronization (default every 24h)
SCHEDULE = @every 24h
; Create new users, update existing user data and disable users that are not in external source anymore (default)
; or only create new users if UPDATE_EXISTING is set to false
UPDATE_EXISTING = true
2020-09-25 13:37:33 -04:00
; Clean-up deleted branches
[cron.deleted_branches_cleanup]
ENABLED = true
; Clean-up deleted branches when starting server (default true)
RUN_AT_START = true
; Notice if not success
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
; Interval as a duration between each synchronization (default every 24h)
SCHEDULE = @every 24h
; deleted branches than OLDER_THAN ago are subject to deletion
OLDER_THAN = 24h
2021-01-26 16:02:42 -05:00
; Cleanup hook_task table
[cron.cleanup_hook_task_table]
; Whether to enable the job
ENABLED = true
; Whether to always run at start up time (if ENABLED)
RUN_AT_START = false
; Time interval for job to run
SCHEDULE = @every 24h
; OlderThan or PerWebhook. How the records are removed, either by age (i.e. how long ago hook_task record was delivered) or by the number to keep per webhook (i.e. keep most recent x deliveries per webhook).
CLEANUP_TYPE = OlderThan
; If CLEANUP_TYPE is set to OlderThan, then any delivered hook_task records older than this expression will be deleted.
OLDER_THAN = 168h
; If CLEANUP_TYPE is set to PerWebhook, this is number of hook_task records to keep for a webhook (i.e. keep the most recent x deliveries).
NUMBER_TO_KEEP = 10
2020-10-22 14:02:28 -04:00
; Extended cron task - not enabled by default
2020-09-25 13:37:33 -04:00
; Delete all unactivated accounts
[cron.delete_inactive_accounts]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @annually
OLDER_THAN = 168h
; Delete all repository archives
[cron.delete_repo_archives]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @annually
; Garbage collect all repositories
[cron.git_gc_repos]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
TIMEOUT = 60s
; Arguments for command 'git gc'
; The default value is same with [git] -> GC_ARGS
ARGS =
; Update the '.ssh/authorized_keys' file with Gitea SSH keys
[cron.resync_all_sshkeys]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
; Resynchronize pre-receive, update and post-receive hooks of all repositories.
[cron.resync_all_hooks]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
; Reinitialize all missing Git repositories for which records exist
[cron.reinit_missing_repos]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
; Delete all repositories missing their Git files
[cron.delete_missing_repos]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
; Delete generated repository avatars
[cron.delete_generated_repository_avatars]
ENABLED = false
RUN_AT_START = false
2020-10-01 02:57:57 -04:00
NO_SUCCESS_NOTICE = false
2020-09-25 13:37:33 -04:00
SCHEDULE = @every 72h
2014-09-17 14:22:51 -04:00
[git]
2019-07-07 03:26:56 -04:00
; The path of git executable. If empty, Gitea searches through the PATH environment.
PATH =
2016-08-07 12:49:47 -04:00
; Disables highlight of added and removed changes
DISABLE_DIFF_HIGHLIGHT = false
2018-05-10 21:43:46 -04:00
; Max number of lines allowed in a single file in diff view
2016-06-29 11:25:41 -04:00
MAX_GIT_DIFF_LINES = 1000
2018-05-10 21:43:46 -04:00
; Max number of allowed characters in a line in diff view
2017-05-31 21:10:11 -04:00
MAX_GIT_DIFF_LINE_CHARACTERS = 5000
2016-08-07 12:49:47 -04:00
; Max number of files shown in diff view
2016-06-29 11:11:00 -04:00
MAX_GIT_DIFF_FILES = 100
2021-01-18 23:07:38 -05:00
; Set the default commits range size
COMMITS_RANGE_SIZE = 50
; Set the default branches range size
BRANCHES_RANGE_SIZE = 20
2015-12-11 21:23:19 -05:00
; Arguments for command 'git gc', e.g. "--aggressive --auto"
2018-12-04 17:40:42 -05:00
; see more on http://git-scm.com/docs/git-gc/
2016-06-29 11:11:00 -04:00
GC_ARGS =
2019-05-26 05:50:06 -04:00
; If use git wire protocol version 2 when git version >= 2.18, default is true, set to false when you always want git wire protocol version 1
2020-03-08 09:34:38 -04:00
ENABLE_AUTO_GIT_WIRE_PROTOCOL = true
; Respond to pushes to a non-default branch with a URL for creating a Pull Request (if the repository has them enabled)
PULL_REQUEST_PUSH_MESSAGE = true
2014-09-17 14:22:51 -04:00
2016-02-29 19:29:49 -05:00
; Operation timeout in seconds
[git.timeout]
2019-02-09 17:44:24 -05:00
DEFAULT = 360
2016-02-29 19:29:49 -05:00
MIGRATE = 600
MIRROR = 300
CLONE = 300
PULL = 300
2016-08-09 20:24:32 -04:00
GC = 60
2016-02-29 19:29:49 -05:00
2016-08-10 02:47:16 -04:00
[mirror]
2017-04-08 11:27:26 -04:00
; Default interval as a duration between each check
DEFAULT_INTERVAL = 8h
; Min interval as a duration must be > 1m
MIN_INTERVAL = 10m
2016-08-10 02:47:16 -04:00
2016-07-04 05:27:06 -04:00
[api]
2018-07-27 20:19:01 -04:00
; Enables Swagger. True or false; default is true.
ENABLE_SWAGGER = true
2018-05-10 21:43:46 -04:00
; Max number of items in a page
2016-07-04 05:27:06 -04:00
MAX_RESPONSE_ITEMS = 50
2019-01-24 13:59:27 -05:00
; Default paging number of api
DEFAULT_PAGING_NUM = 30
2019-02-06 13:19:26 -05:00
; Default and maximum number of items per page for git trees api
DEFAULT_GIT_TREES_PER_PAGE = 1000
2019-04-17 12:06:35 -04:00
; Default size of a blob returned by the blobs API (default is 10MiB)
DEFAULT_MAX_BLOB_SIZE = 10485760
2016-07-04 05:27:06 -04:00
2019-03-08 11:42:50 -05:00
[oauth2]
; Enables OAuth2 provider
2019-05-21 21:48:34 -04:00
ENABLE = true
2019-03-08 11:42:50 -05:00
; Lifetime of an OAuth2 access token in seconds
2020-11-28 01:12:22 -05:00
ACCESS_TOKEN_EXPIRATION_TIME = 3600
2020-08-29 16:02:38 -04:00
; Lifetime of an OAuth2 refresh token in hours
2020-11-28 01:12:22 -05:00
REFRESH_TOKEN_EXPIRATION_TIME = 730
2019-04-12 03:50:21 -04:00
; Check if refresh token got already used
2020-11-28 01:12:22 -05:00
INVALIDATE_REFRESH_TOKENS = false
2020-08-24 17:49:26 -04:00
; OAuth2 authentication secret for access and refresh tokens, change this yourself to a unique string. CLI generate option is helpful in this case. https://docs.gitea.io/en-us/command-line/#generate
2020-11-28 01:12:22 -05:00
JWT_SECRET =
2020-04-22 18:47:23 -04:00
; Maximum length of oauth2 token/cookie stored on server
2020-11-28 01:12:22 -05:00
MAX_TOKEN_LENGTH = 32767
2019-03-08 11:42:50 -05:00
2014-07-26 00:24:27 -04:00
[i18n]
2020-06-05 04:07:56 -04:00
LANGS = en-US,zh-CN,zh-HK,zh-TW,de-DE,fr-FR,nl-NL,lv-LV,ru-RU,uk-UA,ja-JP,es-ES,pt-BR,pt-PT,pl-PL,bg-BG,it-IT,fi-FI,tr-TR,cs-CZ,sr-SP,sv-SE,ko-KR
NAMES = English,简体中文,繁體中文(香港),繁體中文(台灣),Deutsch,français,Nederlands,latviešu,русский,Українська,日本語,español,português do Brasil,Português de Portugal,polski,български,italiano,suomi,Türkçe,čeština,српски,svenska,한국어
2015-03-23 10:19:19 -04:00
2018-05-24 14:07:02 -04:00
[U2F]
2019-02-07 10:47:40 -05:00
; NOTE: THE DEFAULT VALUES HERE WILL NEED TO BE CHANGED
2018-05-24 14:07:02 -04:00
; Two Factor authentication with security keys
; https://developers.yubico.com/U2F/App_ID.html
2019-02-07 10:47:40 -05:00
;APP_ID = http://localhost:3000/
2020-08-20 13:41:08 -04:00
; Comma separated list of trusted facets
2019-02-07 10:47:40 -05:00
;TRUSTED_FACETS = http://localhost:3000/
2018-05-24 14:07:02 -04:00
2015-12-17 22:31:34 -05:00
; Extension mapping to highlight class
; e.g. .toml=ini
[highlight.mapping]
2015-03-23 10:19:19 -04:00
[other]
2015-08-09 20:44:43 -04:00
SHOW_FOOTER_BRANDING = false
2016-11-07 08:26:13 -05:00
; Show version information about Gitea and Go in the footer
2015-11-18 16:32:31 -05:00
SHOW_FOOTER_VERSION = true
2018-05-10 21:43:46 -04:00
; Show template execution time in the footer
2016-09-01 01:01:32 -04:00
SHOW_FOOTER_TEMPLATE_LOAD_TIME = true
2017-11-07 01:33:06 -05:00
2020-04-29 07:34:59 -04:00
[markup.sanitizer.1]
; The following keys can appear once to define a sanitation policy rule.
; This section can appear multiple times by adding a unique alphanumeric suffix to define multiple rules.
; e.g., [markup.sanitizer.1] -> [markup.sanitizer.2] -> [markup.sanitizer.TeX]
2019-12-07 14:49:04 -05:00
;ELEMENT = span
;ALLOW_ATTR = class
;REGEXP = ^(info|warning|error)$
2017-11-07 01:33:06 -05:00
[markup.asciidoc]
ENABLED = false
; List of file extensions that should be rendered by an external command
FILE_EXTENSIONS = .adoc,.asciidoc
; External command to render all matching extensions
RENDER_COMMAND = "asciidoc --out-file=- -"
2018-05-10 21:43:46 -04:00
; Don't pass the file on STDIN, pass the filename as argument instead.
2017-11-22 23:00:48 -05:00
IS_INPUT_FILE = false
2018-11-04 22:20:00 -05:00
[metrics]
; Enables metrics endpoint. True or false; default is false.
ENABLED = false
; If you want to add authorization, specify a token here
TOKEN =
2019-10-13 09:23:14 -04:00
[task]
; Task queue type, could be `channel` or `redis`.
QUEUE_TYPE = channel
; Task queue length, available only when `QUEUE_TYPE` is `channel`.
QUEUE_LENGTH = 1000
2019-10-21 17:20:47 -04:00
; Task queue connection string, available only when `QUEUE_TYPE` is `redis`.
2019-10-13 09:23:14 -04:00
; If there is a password of redis, use `addrs=127.0.0.1:6379 password=123 db=0`.
2019-10-15 03:14:58 -04:00
QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"
2019-11-16 03:30:06 -05:00
[migrations]
; Max attempts per http/https request on migrations.
MAX_ATTEMPTS = 3
; Backoff time per http/https request retry (seconds)
2019-11-21 13:32:02 -05:00
RETRY_BACKOFF = 3
2020-11-28 19:37:58 -05:00
; Allowed domains for migrating, default is blank. Blank means everything will be allowed.
; Multiple domains could be separated by commas.
ALLOWED_DOMAINS =
; Blocklist for migrating, default is blank. Multiple domains could be separated by commas.
; When ALLOWED_DOMAINS is not blank, this option will be ignored.
BLOCKED_DOMAINS =
; Allow private addresses defined by RFC 1918, RFC 1122, RFC 4632 and RFC 4291 (false by default)
ALLOW_LOCALNETWORKS = false
2020-09-29 05:05:13 -04:00
; default storage for attachments, lfs and avatars
[storage]
; storage type
STORAGE_TYPE = local
; lfs storage will override storage
[lfs]
STORAGE_TYPE = local
; customize storage
;[storage.my_minio]
;STORAGE_TYPE = minio
; Minio endpoint to connect only available when STORAGE_TYPE is `minio`
;MINIO_ENDPOINT = localhost:9000
; Minio accessKeyID to connect only available when STORAGE_TYPE is `minio`
;MINIO_ACCESS_KEY_ID =
; Minio secretAccessKey to connect only available when STORAGE_TYPE is `minio`
;MINIO_SECRET_ACCESS_KEY =
; Minio bucket to store the attachments only available when STORAGE_TYPE is `minio`
;MINIO_BUCKET = gitea
; Minio location to create bucket only available when STORAGE_TYPE is `minio`
;MINIO_LOCATION = us-east-1
; Minio enabled ssl only available when STORAGE_TYPE is `minio`
;MINIO_USE_SSL = false