You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

app.example.ini 54KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272
  1. ; This file lists the default values used by Gitea
  2. ; Copy required sections to your own app.ini (default is custom/conf/app.ini)
  3. ; and modify as needed.
  4. ; Do not copy the whole file as-is, as it contains some invalid sections for illustrative purposes.
  5. ; If you don't know what a setting is you should not set it.
  6. ; see https://docs.gitea.io/en-us/config-cheat-sheet/ for additional documentation.
  7. ; App name that shows in every page title
  8. APP_NAME = Gitea: Git with a cup of tea
  9. ; Change it if you run locally
  10. RUN_USER = git
  11. ; Application run mode, affects performance and debugging. Either "dev", "prod" or "test", default is "prod"
  12. RUN_MODE = prod
  13. [project]
  14. ; Default templates for project boards
  15. PROJECT_BOARD_BASIC_KANBAN_TYPE = To Do, In Progress, Done
  16. PROJECT_BOARD_BUG_TRIAGE_TYPE = Needs Triage, High Priority, Low Priority, Closed
  17. [repository]
  18. ; 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`.
  19. ROOT =
  20. ; The script type this server supports. Usually this is `bash`, but some users report that only `sh` is available.
  21. SCRIPT_TYPE = bash
  22. ; DETECTED_CHARSETS_ORDER tie-break order for detected charsets.
  23. ; If the charsets have equal confidence, tie-breaking will be done by order in this list
  24. ; with charsets earlier in the list chosen in preference to those later.
  25. ; Adding "defaults" will place the unused charsets at that position.
  26. 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
  27. ; Default ANSI charset to override non-UTF-8 charsets to
  28. ANSI_CHARSET =
  29. ; Force every new repository to be private
  30. FORCE_PRIVATE = false
  31. ; Default privacy setting when creating a new repository, allowed values: last, private, public. Default is last which means the last setting used.
  32. DEFAULT_PRIVATE = last
  33. ; Default private when using push-to-create
  34. DEFAULT_PUSH_CREATE_PRIVATE = true
  35. ; Global limit of repositories per user, applied at creation time. -1 means no limit
  36. MAX_CREATION_LIMIT = -1
  37. ; Mirror sync queue length, increase if mirror syncing starts hanging
  38. MIRROR_QUEUE_LENGTH = 1000
  39. ; Patch test queue length, increase if pull request patch testing starts hanging
  40. PULL_REQUEST_QUEUE_LENGTH = 1000
  41. ; Preferred Licenses to place at the top of the List
  42. ; The name here must match the filename in conf/license or custom/conf/license
  43. PREFERRED_LICENSES = Apache License 2.0,MIT License
  44. ; Disable the ability to interact with repositories using the HTTP protocol
  45. DISABLE_HTTP_GIT = false
  46. ; Value for Access-Control-Allow-Origin header, default is not to present
  47. ; WARNING: This maybe harmful to you website if you do not give it a right value.
  48. ACCESS_CONTROL_ALLOW_ORIGIN =
  49. ; Force ssh:// clone url instead of scp-style uri when default SSH port is used
  50. USE_COMPAT_SSH_URI = false
  51. ; Close issues as long as a commit on any branch marks it as fixed
  52. DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH = false
  53. ; Allow users to push local repositories to Gitea and have them automatically created for a user or an org
  54. ENABLE_PUSH_CREATE_USER = false
  55. ENABLE_PUSH_CREATE_ORG = false
  56. ; Comma separated list of globally disabled repo units. Allowed values: repo.issues, repo.ext_issues, repo.pulls, repo.wiki, repo.ext_wiki
  57. DISABLED_REPO_UNITS =
  58. ; Comma separated list of default repo units. Allowed values: repo.code, repo.releases, repo.issues, repo.pulls, repo.wiki, repo.projects.
  59. ; Note: Code and Releases can currently not be deactivated. If you specify default repo units you should still list them for future compatibility.
  60. ; External wiki and issue tracker can't be enabled by default as it requires additional settings.
  61. ; Disabled repo units will not be added to new repositories regardless if it is in the default list.
  62. DEFAULT_REPO_UNITS = repo.code,repo.releases,repo.issues,repo.pulls,repo.wiki,repo.projects
  63. ; Prefix archive files by placing them in a directory named after the repository
  64. PREFIX_ARCHIVE_FILES = true
  65. ; Disable the creation of new mirrors. Pre-existing mirrors remain valid.
  66. DISABLE_MIRRORS = false
  67. ; Disable migrating feature.
  68. DISABLE_MIGRATIONS = false
  69. ; The default branch name of new repositories
  70. DEFAULT_BRANCH = master
  71. ; Allow adoption of unadopted repositories
  72. ALLOW_ADOPTION_OF_UNADOPTED_REPOSITORIES = false
  73. ; Allow deletion of unadopted repositories
  74. ALLOW_DELETION_OF_UNADOPTED_REPOSITORIES = false
  75. [repository.editor]
  76. ; List of file extensions for which lines should be wrapped in the Monaco editor
  77. ; Separate extensions with a comma. To line wrap files without an extension, just put a comma
  78. LINE_WRAP_EXTENSIONS = .txt,.md,.markdown,.mdown,.mkd,
  79. ; Valid file modes that have a preview API associated with them, such as api/v1/markdown
  80. ; Separate the values by commas. The preview tab in edit mode won't be displayed if the file extension doesn't match
  81. PREVIEWABLE_FILE_MODES = markdown
  82. [repository.local]
  83. ; Path for local repository copy. Defaults to `tmp/local-repo`
  84. LOCAL_COPY_PATH = tmp/local-repo
  85. [repository.upload]
  86. ; Whether repository file uploads are enabled. Defaults to `true`
  87. ENABLED = true
  88. ; Path for uploads. Defaults to `data/tmp/uploads` (tmp gets deleted on gitea restart)
  89. TEMP_PATH = data/tmp/uploads
  90. ; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
  91. ALLOWED_TYPES =
  92. ; Max size of each file in megabytes. Defaults to 3MB
  93. FILE_MAX_SIZE = 3
  94. ; Max number of files per upload. Defaults to 5
  95. MAX_FILES = 5
  96. [repository.pull-request]
  97. ; List of prefixes used in Pull Request title to mark them as Work In Progress
  98. WORK_IN_PROGRESS_PREFIXES = WIP:,[WIP]
  99. ; List of keywords used in Pull Request comments to automatically close a related issue
  100. CLOSE_KEYWORDS = close,closes,closed,fix,fixes,fixed,resolve,resolves,resolved
  101. ; List of keywords used in Pull Request comments to automatically reopen a related issue
  102. REOPEN_KEYWORDS = reopen,reopens,reopened
  103. ; In the default merge message for squash commits include at most this many commits
  104. DEFAULT_MERGE_MESSAGE_COMMITS_LIMIT = 50
  105. ; In the default merge message for squash commits limit the size of the commit messages to this
  106. DEFAULT_MERGE_MESSAGE_SIZE = 5120
  107. ; 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
  108. DEFAULT_MERGE_MESSAGE_ALL_AUTHORS = false
  109. ; In default merge messages limit the number of approvers listed as Reviewed-by: to this many
  110. DEFAULT_MERGE_MESSAGE_MAX_APPROVERS = 10
  111. ; In default merge messages only include approvers who are official
  112. DEFAULT_MERGE_MESSAGE_OFFICIAL_APPROVERS_ONLY = true
  113. [repository.issue]
  114. ; List of reasons why a Pull Request or Issue can be locked
  115. LOCK_REASONS = Too heated,Off-topic,Resolved,Spam
  116. [repository.release]
  117. ; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
  118. ALLOWED_TYPES =
  119. [repository.signing]
  120. ; GPG key to use to sign commits, Defaults to the default - that is the value of git config --get user.signingkey
  121. ; run in the context of the RUN_USER
  122. ; Switch to none to stop signing completely
  123. SIGNING_KEY = default
  124. ; If a SIGNING_KEY ID is provided and is not set to default, use the provided Name and Email address as the signer.
  125. ; These should match a publicized name and email address for the key. (When SIGNING_KEY is default these are set to
  126. ; the results of git config --get user.name and git config --get user.email respectively and can only be overrided
  127. ; by setting the SIGNING_KEY ID to the correct ID.)
  128. SIGNING_NAME =
  129. SIGNING_EMAIL =
  130. ; Sets the default trust model for repositories. Options are: collaborator, committer, collaboratorcommitter
  131. DEFAULT_TRUST_MODEL = collaborator
  132. ; Determines when gitea should sign the initial commit when creating a repository
  133. ; Either:
  134. ; - never
  135. ; - pubkey: only sign if the user has a pubkey
  136. ; - twofa: only sign if the user has logged in with twofa
  137. ; - always
  138. ; options other than none and always can be combined as comma separated list
  139. INITIAL_COMMIT = always
  140. ; Determines when to sign for CRUD actions
  141. ; - as above
  142. ; - parentsigned: requires that the parent commit is signed.
  143. CRUD_ACTIONS = pubkey, twofa, parentsigned
  144. ; Determines when to sign Wiki commits
  145. ; - as above
  146. WIKI = never
  147. ; Determines when to sign on merges
  148. ; - basesigned: require that the parent of commit on the base repo is signed.
  149. ; - commitssigned: require that all the commits in the head branch are signed.
  150. ; - approved: only sign when merging an approved pr to a protected branch
  151. MERGES = pubkey, twofa, basesigned, commitssigned
  152. [cors]
  153. ; More information about CORS can be found here: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#The_HTTP_response_headers
  154. ; enable cors headers (disabled by default)
  155. ENABLED = false
  156. ; scheme of allowed requests
  157. SCHEME = http
  158. ; list of requesting domains that are allowed
  159. ALLOW_DOMAIN = *
  160. ; allow subdomains of headers listed above to request
  161. ALLOW_SUBDOMAIN = false
  162. ; list of methods allowed to request
  163. METHODS = GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS
  164. ; max time to cache response
  165. MAX_AGE = 10m
  166. ; allow request with credentials
  167. ALLOW_CREDENTIALS = false
  168. [ui]
  169. ; Number of repositories that are displayed on one explore page
  170. EXPLORE_PAGING_NUM = 20
  171. ; Number of issues that are displayed on one page
  172. ISSUE_PAGING_NUM = 10
  173. ; Number of maximum commits displayed in one activity feed
  174. FEED_MAX_COMMIT_NUM = 5
  175. ; Number of items that are displayed in home feed
  176. FEED_PAGING_NUM = 20
  177. ; Number of maximum commits displayed in commit graph.
  178. GRAPH_MAX_COMMIT_NUM = 100
  179. ; Number of line of codes shown for a code comment
  180. CODE_COMMENT_LINES = 4
  181. ; Value of `theme-color` meta tag, used by Android >= 5.0
  182. ; An invalid color like "none" or "disable" will have the default style
  183. ; More info: https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android
  184. THEME_COLOR_META_TAG = `#6cc644`
  185. ; Max size of files to be displayed (default is 8MiB)
  186. MAX_DISPLAY_FILE_SIZE = 8388608
  187. ; Whether the email of the user should be shown in the Explore Users page
  188. SHOW_USER_EMAIL = true
  189. ; Set the default theme for the Gitea install
  190. DEFAULT_THEME = gitea
  191. ; All available themes. Allow users select personalized themes regardless of the value of `DEFAULT_THEME`.
  192. THEMES = gitea,arc-green
  193. ;All available reactions users can choose on issues/prs and comments.
  194. ;Values can be emoji alias (:smile:) or a unicode emoji.
  195. ;For custom reactions, add a tightly cropped square image to public/emoji/img/reaction_name.png
  196. REACTIONS = +1, -1, laugh, hooray, confused, heart, rocket, eyes
  197. ; Whether the full name of the users should be shown where possible. If the full name isn't set, the username will be used.
  198. DEFAULT_SHOW_FULL_NAME = false
  199. ; Whether to search within description at repository search on explore page.
  200. SEARCH_REPO_DESCRIPTION = true
  201. ; Whether to enable a Service Worker to cache frontend assets
  202. USE_SERVICE_WORKER = true
  203. [ui.admin]
  204. ; Number of users that are displayed on one page
  205. USER_PAGING_NUM = 50
  206. ; Number of repos that are displayed on one page
  207. REPO_PAGING_NUM = 50
  208. ; Number of notices that are displayed on one page
  209. NOTICE_PAGING_NUM = 25
  210. ; Number of organizations that are displayed on one page
  211. ORG_PAGING_NUM = 50
  212. [ui.user]
  213. ; Number of repos that are displayed on one page
  214. REPO_PAGING_NUM = 15
  215. [ui.meta]
  216. AUTHOR = Gitea - Git with a cup of tea
  217. DESCRIPTION = Gitea (Git with a cup of tea) is a painless self-hosted Git service written in Go
  218. KEYWORDS = go,git,self-hosted,gitea
  219. [ui.notification]
  220. ; Control how often the notification endpoint is polled to update the notification
  221. ; The timeout will increase to MAX_TIMEOUT in TIMEOUT_STEPs if the notification count is unchanged
  222. ; Set MIN_TIMEOUT to 0 to turn off
  223. MIN_TIMEOUT = 10s
  224. MAX_TIMEOUT = 60s
  225. TIMEOUT_STEP = 10s
  226. ; This setting determines how often the db is queried to get the latest notification counts.
  227. ; 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
  228. EVENT_SOURCE_UPDATE_TIME = 10s
  229. [ui.svg]
  230. ; 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.
  231. ENABLE_RENDER = true
  232. [markdown]
  233. ; Render soft line breaks as hard line breaks, which means a single newline character between
  234. ; paragraphs will cause a line break and adding trailing whitespace to paragraphs is not
  235. ; necessary to force a line break.
  236. ; Render soft line breaks as hard line breaks for comments
  237. ENABLE_HARD_LINE_BREAK_IN_COMMENTS = true
  238. ; Render soft line breaks as hard line breaks for markdown documents
  239. ENABLE_HARD_LINE_BREAK_IN_DOCUMENTS = false
  240. ; Comma separated list of custom URL-Schemes that are allowed as links when rendering Markdown
  241. ; for example git,magnet,ftp (more at https://en.wikipedia.org/wiki/List_of_URI_schemes)
  242. ; URLs starting with http and https are always displayed, whatever is put in this entry.
  243. CUSTOM_URL_SCHEMES =
  244. ; List of file extensions that should be rendered/edited as Markdown
  245. ; Separate the extensions with a comma. To render files without any extension as markdown, just put a comma
  246. FILE_EXTENSIONS = .md,.markdown,.mdown,.mkd
  247. [server]
  248. ; The protocol the server listens on. One of 'http', 'https', 'unix' or 'fcgi'.
  249. PROTOCOL = http
  250. DOMAIN = localhost
  251. ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
  252. ; when STATIC_URL_PREFIX is empty it will follow ROOT_URL
  253. STATIC_URL_PREFIX =
  254. ; The address to listen on. Either a IPv4/IPv6 address or the path to a unix socket.
  255. HTTP_ADDR = 0.0.0.0
  256. ; The port to listen on. Leave empty when using a unix socket.
  257. HTTP_PORT = 3000
  258. ; If REDIRECT_OTHER_PORT is true, and PROTOCOL is set to https an http server
  259. ; will be started on PORT_TO_REDIRECT and it will redirect plain, non-secure http requests to the main
  260. ; ROOT_URL. Defaults are false for REDIRECT_OTHER_PORT and 80 for
  261. ; PORT_TO_REDIRECT.
  262. REDIRECT_OTHER_PORT = false
  263. PORT_TO_REDIRECT = 80
  264. ; Permission for unix socket
  265. UNIX_SOCKET_PERMISSION = 666
  266. ; Local (DMZ) URL for Gitea workers (such as SSH update) accessing web service.
  267. ; In most cases you do not need to change the default value.
  268. ; Alter it only if your SSH server node is not the same as HTTP node.
  269. ; Do not set this variable if PROTOCOL is set to 'unix'.
  270. LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/
  271. ; Disable SSH feature when not available
  272. DISABLE_SSH = false
  273. ; Whether to use the builtin SSH server or not.
  274. START_SSH_SERVER = false
  275. ; Username to use for the builtin SSH server. If blank, then it is the value of RUN_USER.
  276. BUILTIN_SSH_SERVER_USER =
  277. ; Domain name to be exposed in clone URL
  278. SSH_DOMAIN = %(DOMAIN)s
  279. ; The network interface the builtin SSH server should listen on
  280. SSH_LISTEN_HOST =
  281. ; Port number to be exposed in clone URL
  282. SSH_PORT = 22
  283. ; The port number the builtin SSH server should listen on
  284. SSH_LISTEN_PORT = %(SSH_PORT)s
  285. ; Root path of SSH directory, default is '~/.ssh', but you have to use '/home/git/.ssh'.
  286. SSH_ROOT_PATH =
  287. ; Gitea will create a authorized_keys file by default when it is not using the internal ssh server
  288. ; If you intend to use the AuthorizedKeysCommand functionality then you should turn this off.
  289. SSH_CREATE_AUTHORIZED_KEYS_FILE = true
  290. ; Gitea will create a authorized_principals file by default when it is not using the internal ssh server
  291. ; If you intend to use the AuthorizedPrincipalsCommand functionality then you should turn this off.
  292. SSH_CREATE_AUTHORIZED_PRINCIPALS_FILE = true
  293. ; For the built-in SSH server, choose the ciphers to support for SSH connections,
  294. ; for system SSH this setting has no effect
  295. SSH_SERVER_CIPHERS = aes128-ctr, aes192-ctr, aes256-ctr, aes128-gcm@openssh.com, arcfour256, arcfour128
  296. ; For the built-in SSH server, choose the key exchange algorithms to support for SSH connections,
  297. ; for system SSH this setting has no effect
  298. 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
  299. ; For the built-in SSH server, choose the MACs to support for SSH connections,
  300. ; for system SSH this setting has no effect
  301. SSH_SERVER_MACS = hmac-sha2-256-etm@openssh.com, hmac-sha2-256, hmac-sha1, hmac-sha1-96
  302. ; For the built-in SSH server, choose the keypair to offer as the host key
  303. ; The private key should be at SSH_SERVER_HOST_KEY and the public SSH_SERVER_HOST_KEY.pub
  304. ; relative paths are made absolute relative to the APP_DATA_PATH
  305. SSH_SERVER_HOST_KEYS=ssh/gitea.rsa, ssh/gogs.rsa
  306. ; Directory to create temporary files in when testing public keys using ssh-keygen,
  307. ; default is the system temporary directory.
  308. SSH_KEY_TEST_PATH =
  309. ; Path to ssh-keygen, default is 'ssh-keygen' which means the shell is responsible for finding out which one to call.
  310. SSH_KEYGEN_PATH = ssh-keygen
  311. ; Enable SSH Authorized Key Backup when rewriting all keys, default is true
  312. SSH_AUTHORIZED_KEYS_BACKUP = true
  313. ; Determines which principals to allow
  314. ; - empty: if SSH_TRUSTED_USER_CA_KEYS is empty this will default to off, otherwise will default to email, username.
  315. ; - off: Do not allow authorized principals
  316. ; - email: the principal must match the user's email
  317. ; - username: the principal must match the user's username
  318. ; - anything: there will be no checking on the content of the principal
  319. SSH_AUTHORIZED_PRINCIPALS_ALLOW = email, username
  320. ; Enable SSH Authorized Principals Backup when rewriting all keys, default is true
  321. SSH_AUTHORIZED_PRINCIPALS_BACKUP = true
  322. ; Specifies the public keys of certificate authorities that are trusted to sign user certificates for authentication.
  323. ; Multiple keys should be comma separated.
  324. ; E.g."ssh-<algorithm> <key>". or "ssh-<algorithm> <key1>, ssh-<algorithm> <key2>".
  325. ; For more information see "TrustedUserCAKeys" in the sshd config manpages.
  326. SSH_TRUSTED_USER_CA_KEYS =
  327. ; Absolute path of the `TrustedUserCaKeys` file gitea will manage.
  328. ; Default this `RUN_USER`/.ssh/gitea-trusted-user-ca-keys.pem
  329. ; If you're running your own ssh server and you want to use the gitea managed file you'll also need to modify your
  330. ; sshd_config to point to this file. The official docker image will automatically work without further configuration.
  331. SSH_TRUSTED_USER_CA_KEYS_FILENAME =
  332. ; Enable exposure of SSH clone URL to anonymous visitors, default is false
  333. SSH_EXPOSE_ANONYMOUS = false
  334. ; Indicate whether to check minimum key size with corresponding type
  335. MINIMUM_KEY_SIZE_CHECK = false
  336. ; Disable CDN even in "prod" mode
  337. OFFLINE_MODE = false
  338. DISABLE_ROUTER_LOG = false
  339. ; Generate steps:
  340. ; $ ./gitea cert -ca=true -duration=8760h0m0s -host=myhost.example.com
  341. ;
  342. ; Or from a .pfx file exported from the Windows certificate store (do
  343. ; not forget to export the private key):
  344. ; $ openssl pkcs12 -in cert.pfx -out cert.pem -nokeys
  345. ; $ openssl pkcs12 -in cert.pfx -out key.pem -nocerts -nodes
  346. ; Paths are relative to CUSTOM_PATH
  347. CERT_FILE = https/cert.pem
  348. KEY_FILE = https/key.pem
  349. ; Root directory containing templates and static files.
  350. ; default is the path where Gitea is executed
  351. STATIC_ROOT_PATH =
  352. ; Default path for App data
  353. APP_DATA_PATH = data
  354. ; Enable gzip compression for runtime-generated content, static resources excluded
  355. ENABLE_GZIP = false
  356. ; Application profiling (memory and cpu)
  357. ; For "web" command it listens on localhost:6060
  358. ; For "serve" command it dumps to disk at PPROF_DATA_PATH as (cpuprofile|memprofile)_<username>_<temporary id>
  359. ENABLE_PPROF = false
  360. ; PPROF_DATA_PATH, use an absolute path when you start gitea as service
  361. PPROF_DATA_PATH = data/tmp/pprof
  362. ; Landing page, can be "home", "explore", "organizations" or "login"
  363. ; The "login" choice is not a security measure but just a UI flow change, use REQUIRE_SIGNIN_VIEW to force users to log in.
  364. LANDING_PAGE = home
  365. ; Enables git-lfs support. true or false, default is false.
  366. LFS_START_SERVER = false
  367. ; Where your lfs files reside, default is data/lfs.
  368. LFS_CONTENT_PATH = data/lfs
  369. ; LFS authentication secret, change this yourself
  370. LFS_JWT_SECRET =
  371. ; LFS authentication validity period (in time.Duration), pushes taking longer than this may fail.
  372. LFS_HTTP_AUTH_EXPIRY = 20m
  373. ; Maximum allowed LFS file size in bytes (Set to 0 for no limit).
  374. LFS_MAX_FILE_SIZE = 0
  375. ; Maximum number of locks returned per page
  376. LFS_LOCKS_PAGING_NUM = 50
  377. ; Allow graceful restarts using SIGHUP to fork
  378. ALLOW_GRACEFUL_RESTARTS = true
  379. ; After a restart the parent will finish ongoing requests before
  380. ; shutting down. Force shutdown if this process takes longer than this delay.
  381. ; set to a negative value to disable
  382. GRACEFUL_HAMMER_TIME = 60s
  383. ; Allows the setting of a startup timeout and waithint for Windows as SVC service
  384. ; 0 disables this.
  385. STARTUP_TIMEOUT = 0
  386. ; 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
  387. STATIC_CACHE_TIME = 6h
  388. ; Define allowed algorithms and their minimum key length (use -1 to disable a type)
  389. [ssh.minimum_key_sizes]
  390. ED25519 = 256
  391. ECDSA = 256
  392. RSA = 2048
  393. DSA = -1 ; set to 1024 to switch on
  394. [database]
  395. ; Database to use. Either "mysql", "postgres", "mssql" or "sqlite3".
  396. DB_TYPE = mysql
  397. HOST = 127.0.0.1:3306
  398. NAME = gitea
  399. USER = root
  400. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  401. PASSWD =
  402. ; For Postgres, schema to use if different from "public". The schema must exist beforehand,
  403. ; the user must have creation privileges on it, and the user search path must be set
  404. ; to the look into the schema first. e.g.:ALTER USER user SET SEARCH_PATH = schema_name,"$user",public;
  405. SCHEMA =
  406. ; For Postgres, either "disable" (default), "require", or "verify-full"
  407. ; For MySQL, either "false" (default), "true", or "skip-verify"
  408. SSL_MODE = disable
  409. ; For MySQL only, either "utf8" or "utf8mb4", default is "utf8mb4".
  410. ; NOTICE: for "utf8mb4" you must use MySQL InnoDB > 5.6. Gitea is unable to check this.
  411. CHARSET = utf8mb4
  412. ; For "sqlite3" and "tidb", use an absolute path when you start gitea as service
  413. PATH = data/gitea.db
  414. ; For "sqlite3" only. Query timeout
  415. SQLITE_TIMEOUT = 500
  416. ; For iterate buffer, default is 50
  417. ITERATE_BUFFER_SIZE = 50
  418. ; Show the database generated SQL
  419. LOG_SQL = true
  420. ; Maximum number of DB Connect retries
  421. DB_RETRIES = 10
  422. ; Backoff time per DB retry (time.Duration)
  423. DB_RETRY_BACKOFF = 3s
  424. ; Max idle database connections on connnection pool, default is 2
  425. MAX_IDLE_CONNS = 2
  426. ; Database connection max life time, default is 0 or 3s mysql (See #6804 & #7071 for reasoning)
  427. CONN_MAX_LIFETIME = 3s
  428. ; Database maximum number of open connections, default is 0 meaning no maximum
  429. MAX_OPEN_CONNS = 0
  430. [indexer]
  431. ; Issue indexer type, currently support: bleve, db or elasticsearch, default is bleve
  432. ISSUE_INDEXER_TYPE = bleve
  433. ; Issue indexer connection string, available when ISSUE_INDEXER_TYPE is elasticsearch
  434. ISSUE_INDEXER_CONN_STR = http://elastic:changeme@localhost:9200
  435. ; Issue indexer name, available when ISSUE_INDEXER_TYPE is elasticsearch
  436. ISSUE_INDEXER_NAME = gitea_issues
  437. ; Issue indexer storage path, available when ISSUE_INDEXER_TYPE is bleve
  438. ISSUE_INDEXER_PATH = indexers/issues.bleve
  439. ; Issue indexer queue, currently support: channel, levelqueue or redis, default is levelqueue
  440. ISSUE_INDEXER_QUEUE_TYPE = levelqueue
  441. ; When ISSUE_INDEXER_QUEUE_TYPE is levelqueue, this will be the path where the queue will be saved.
  442. ; This can be overriden by `ISSUE_INDEXER_QUEUE_CONN_STR`.
  443. ; default is indexers/issues.queue
  444. ISSUE_INDEXER_QUEUE_DIR = indexers/issues.queue
  445. ; When `ISSUE_INDEXER_QUEUE_TYPE` is `redis`, this will store the redis connection string.
  446. ; When `ISSUE_INDEXER_QUEUE_TYPE` is `levelqueue`, this is a directory or additional options of
  447. ; the form `leveldb://path/to/db?option=value&....`, and overrides `ISSUE_INDEXER_QUEUE_DIR`.
  448. ISSUE_INDEXER_QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"
  449. ; Batch queue number, default is 20
  450. ISSUE_INDEXER_QUEUE_BATCH_NUMBER = 20
  451. ; Timeout the indexer if it takes longer than this to start.
  452. ; Set to zero to disable timeout.
  453. STARTUP_TIMEOUT = 30s
  454. ; repo indexer by default disabled, since it uses a lot of disk space
  455. REPO_INDEXER_ENABLED = false
  456. ; Code search engine type, could be `bleve` or `elasticsearch`.
  457. REPO_INDEXER_TYPE = bleve
  458. ; Index file used for code search.
  459. REPO_INDEXER_PATH = indexers/repos.bleve
  460. ; Code indexer connection string, available when `REPO_INDEXER_TYPE` is elasticsearch. i.e. http://elastic:changeme@localhost:9200
  461. REPO_INDEXER_CONN_STR =
  462. ; Code indexer name, available when `REPO_INDEXER_TYPE` is elasticsearch
  463. REPO_INDEXER_NAME = gitea_codes
  464. UPDATE_BUFFER_LEN = 20
  465. MAX_FILE_SIZE = 1048576
  466. ; A comma separated list of glob patterns (see https://github.com/gobwas/glob) to include
  467. ; in the index; default is empty
  468. REPO_INDEXER_INCLUDE =
  469. ; A comma separated list of glob patterns to exclude from the index; ; default is empty
  470. REPO_INDEXER_EXCLUDE =
  471. [queue]
  472. ; Specific queues can be individually configured with [queue.name]. [queue] provides defaults
  473. ;
  474. ; General queue queue type, currently support: persistable-channel, channel, level, redis, dummy
  475. ; default to persistable-channel
  476. TYPE = persistable-channel
  477. ; data-dir for storing persistable queues and level queues, individual queues will be named by their type
  478. DATADIR = queues/
  479. ; Default queue length before a channel queue will block
  480. LENGTH = 20
  481. ; Batch size to send for batched queues
  482. BATCH_LENGTH = 20
  483. ; Connection string for redis queues this will store the redis connection string.
  484. ; When `TYPE` is `persistable-channel`, this provides a directory for the underlying leveldb
  485. ; or additional options of the form `leveldb://path/to/db?option=value&....`, and will override `DATADIR`.
  486. CONN_STR = "addrs=127.0.0.1:6379 db=0"
  487. ; Provides the suffix of the default redis/disk queue name - specific queues can be overriden within in their [queue.name] sections.
  488. QUEUE_NAME = "_queue"
  489. ; Provides the suffix of the default redis/disk unique queue set name - specific queues can be overriden within in their [queue.name] sections.
  490. SET_NAME = "_unique"
  491. ; If the queue cannot be created at startup - level queues may need a timeout at startup - wrap the queue:
  492. WRAP_IF_NECESSARY = true
  493. ; Attempt to create the wrapped queue at max
  494. MAX_ATTEMPTS = 10
  495. ; Timeout queue creation
  496. TIMEOUT = 15m30s
  497. ; Create a pool with this many workers
  498. WORKERS = 1
  499. ; Dynamically scale the worker pool to at this many workers
  500. MAX_WORKERS = 10
  501. ; Add boost workers when the queue blocks for BLOCK_TIMEOUT
  502. BLOCK_TIMEOUT = 1s
  503. ; Remove the boost workers after BOOST_TIMEOUT
  504. BOOST_TIMEOUT = 5m
  505. ; During a boost add BOOST_WORKERS
  506. BOOST_WORKERS = 5
  507. [admin]
  508. ; Disallow regular (non-admin) users from creating organizations.
  509. DISABLE_REGULAR_ORG_CREATION = false
  510. ; Default configuration for email notifications for users (user configurable). Options: enabled, onmention, disabled
  511. DEFAULT_EMAIL_NOTIFICATIONS = enabled
  512. [security]
  513. ; Whether the installer is disabled
  514. INSTALL_LOCK = false
  515. ; !!CHANGE THIS TO KEEP YOUR USER DATA SAFE!!
  516. SECRET_KEY = !#@FDEWREWR&*(
  517. ; How long to remember that a user is logged in before requiring relogin (in days)
  518. LOGIN_REMEMBER_DAYS = 7
  519. COOKIE_USERNAME = gitea_awesome
  520. COOKIE_REMEMBER_NAME = gitea_incredible
  521. ; Reverse proxy authentication header name of user name
  522. REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER
  523. REVERSE_PROXY_AUTHENTICATION_EMAIL = X-WEBAUTH-EMAIL
  524. ; Interpret X-Forwarded-For header or the X-Real-IP header and set this as the remote IP for the request
  525. REVERSE_PROXY_LIMIT = 1
  526. ; List of IP addresses and networks seperated by comma of trusted proxy servers. Use `*` to trust all.
  527. REVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128
  528. ; The minimum password length for new Users
  529. MIN_PASSWORD_LENGTH = 6
  530. ; Set to true to allow users to import local server paths
  531. IMPORT_LOCAL_PATHS = false
  532. ; Set to false to allow users with git hook privileges to create custom git hooks.
  533. ; Custom git hooks can be used to perform arbitrary code execution on the host operating system.
  534. ; This enables the users to access and modify this config file and the Gitea database and interrupt the Gitea service.
  535. ; By modifying the Gitea database, users can gain Gitea administrator privileges.
  536. ; 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.
  537. ; WARNING: This maybe harmful to you website or your operating system.
  538. DISABLE_GIT_HOOKS = true
  539. ; Set to true to disable webhooks feature.
  540. DISABLE_WEBHOOKS = false
  541. ; Set to false to allow pushes to gitea repositories despite having an incomplete environment - NOT RECOMMENDED
  542. ONLY_ALLOW_PUSH_IF_GITEA_ENVIRONMENT_SET = true
  543. ;Comma separated list of character classes required to pass minimum complexity.
  544. ;If left empty or no valid values are specified, the default is off (no checking)
  545. ;Classes include "lower,upper,digit,spec"
  546. PASSWORD_COMPLEXITY = off
  547. ; Password Hash algorithm, either "argon2", "pbkdf2", "scrypt" or "bcrypt"
  548. PASSWORD_HASH_ALGO = pbkdf2
  549. ; Set false to allow JavaScript to read CSRF cookie
  550. CSRF_COOKIE_HTTP_ONLY = true
  551. ; Validate against https://haveibeenpwned.com/Passwords to see if a password has been exposed
  552. PASSWORD_CHECK_PWN = false
  553. [openid]
  554. ;
  555. ; OpenID is an open, standard and decentralized authentication protocol.
  556. ; Your identity is the address of a webpage you provide, which describes
  557. ; how to prove you are in control of that page.
  558. ;
  559. ; For more info: https://en.wikipedia.org/wiki/OpenID
  560. ;
  561. ; Current implementation supports OpenID-2.0
  562. ;
  563. ; Tested to work providers at the time of writing:
  564. ; - Any GNUSocial node (your.hostname.tld/username)
  565. ; - Any SimpleID provider (http://simpleid.koinic.net)
  566. ; - http://openid.org.cn/
  567. ; - openid.stackexchange.com
  568. ; - login.launchpad.net
  569. ; - <username>.livejournal.com
  570. ;
  571. ; Whether to allow signin in via OpenID
  572. ENABLE_OPENID_SIGNIN = true
  573. ; Whether to allow registering via OpenID
  574. ; Do not include to rely on rhw DISABLE_REGISTRATION setting
  575. ;ENABLE_OPENID_SIGNUP = true
  576. ; Allowed URI patterns (POSIX regexp).
  577. ; Space separated.
  578. ; Only these would be allowed if non-blank.
  579. ; Example value: trusted.domain.org trusted.domain.net
  580. WHITELISTED_URIS =
  581. ; Forbidden URI patterns (POSIX regexp).
  582. ; Space separated.
  583. ; Only used if WHITELISTED_URIS is blank.
  584. ; Example value: loadaverage.org/badguy stackexchange.com/.*spammer
  585. BLACKLISTED_URIS =
  586. [service]
  587. ; Time limit to confirm account/email registration
  588. ACTIVE_CODE_LIVE_MINUTES = 180
  589. ; Time limit to perform the reset of a forgotten password
  590. RESET_PASSWD_CODE_LIVE_MINUTES = 180
  591. ; Whether a new user needs to confirm their email when registering.
  592. REGISTER_EMAIL_CONFIRM = false
  593. ; Whether a new user needs to be confirmed manually after registration. (Requires `REGISTER_EMAIL_CONFIRM` to be disabled.)
  594. REGISTER_MANUAL_CONFIRM = false
  595. ; List of domain names that are allowed to be used to register on a Gitea instance
  596. ; gitea.io,example.com
  597. EMAIL_DOMAIN_WHITELIST =
  598. ; Comma-separated list of domain names that are not allowed to be used to register on a Gitea instance
  599. EMAIL_DOMAIN_BLOCKLIST =
  600. ; Disallow registration, only allow admins to create accounts.
  601. DISABLE_REGISTRATION = false
  602. ; Allow registration only using third-party services, it works only when DISABLE_REGISTRATION is false
  603. ALLOW_ONLY_EXTERNAL_REGISTRATION = false
  604. ; User must sign in to view anything.
  605. REQUIRE_SIGNIN_VIEW = false
  606. ; Mail notification
  607. ENABLE_NOTIFY_MAIL = false
  608. ; This setting enables gitea to be signed in with HTTP BASIC Authentication using the user's password
  609. ; If you set this to false you will not be able to access the tokens endpoints on the API with your password
  610. ; Please note that setting this to false will not disable OAuth Basic or Basic authentication using a token
  611. ENABLE_BASIC_AUTHENTICATION = true
  612. ; More detail: https://github.com/gogits/gogs/issues/165
  613. ENABLE_REVERSE_PROXY_AUTHENTICATION = false
  614. ENABLE_REVERSE_PROXY_AUTO_REGISTRATION = false
  615. ENABLE_REVERSE_PROXY_EMAIL = false
  616. ; Enable captcha validation for registration
  617. ENABLE_CAPTCHA = false
  618. ; Type of captcha you want to use. Options: image, recaptcha, hcaptcha
  619. CAPTCHA_TYPE = image
  620. ; Enable recaptcha to use Google's recaptcha service
  621. ; Go to https://www.google.com/recaptcha/admin to sign up for a key
  622. RECAPTCHA_SECRET =
  623. RECAPTCHA_SITEKEY =
  624. ; For hCaptcha, create an account at https://accounts.hcaptcha.com/login to get your keys
  625. HCAPTCHA_SECRET =
  626. HCAPTCHA_SITEKEY =
  627. ; Change this to use recaptcha.net or other recaptcha service
  628. RECAPTCHA_URL = https://www.google.com/recaptcha/
  629. ; Default value for KeepEmailPrivate
  630. ; Each new user will get the value of this setting copied into their profile
  631. DEFAULT_KEEP_EMAIL_PRIVATE = false
  632. ; Default value for AllowCreateOrganization
  633. ; Every new user will have rights set to create organizations depending on this setting
  634. DEFAULT_ALLOW_CREATE_ORGANIZATION = true
  635. ; Either "public", "limited" or "private", default is "public"
  636. ; Limited is for signed user only
  637. ; Private is only for member of the organization
  638. ; Public is for everyone
  639. DEFAULT_ORG_VISIBILITY = public
  640. ; Default value for DefaultOrgMemberVisible
  641. ; True will make the membership of the users visible when added to the organisation
  642. DEFAULT_ORG_MEMBER_VISIBLE = false
  643. ; Default value for EnableDependencies
  644. ; Repositories will use dependencies by default depending on this setting
  645. DEFAULT_ENABLE_DEPENDENCIES = true
  646. ; Dependencies can be added from any repository where the user is granted access or only from the current repository depending on this setting.
  647. ALLOW_CROSS_REPOSITORY_DEPENDENCIES = true
  648. ; Enable heatmap on users profiles.
  649. ENABLE_USER_HEATMAP = true
  650. ; Enable Timetracking
  651. ENABLE_TIMETRACKING = true
  652. ; Default value for EnableTimetracking
  653. ; Repositories will use timetracking by default depending on this setting
  654. DEFAULT_ENABLE_TIMETRACKING = true
  655. ; Default value for AllowOnlyContributorsToTrackTime
  656. ; Only users with write permissions can track time if this is true
  657. DEFAULT_ALLOW_ONLY_CONTRIBUTORS_TO_TRACK_TIME = true
  658. ; Default value for the domain part of the user's email address in the git log
  659. ; if he has set KeepEmailPrivate to true. The user's email will be replaced with a
  660. ; concatenation of the user name in lower case, "@" and NO_REPLY_ADDRESS.
  661. NO_REPLY_ADDRESS = noreply.%(DOMAIN)s
  662. ; Show Registration button
  663. SHOW_REGISTRATION_BUTTON = true
  664. ; Show milestones dashboard page - a view of all the user's milestones
  665. SHOW_MILESTONES_DASHBOARD_PAGE = true
  666. ; Default value for AutoWatchNewRepos
  667. ; When adding a repo to a team or creating a new repo all team members will watch the
  668. ; repo automatically if enabled
  669. AUTO_WATCH_NEW_REPOS = true
  670. ; Default value for AutoWatchOnChanges
  671. ; Make the user watch a repository When they commit for the first time
  672. AUTO_WATCH_ON_CHANGES = false
  673. ; Minimum amount of time a user must exist before comments are kept when the user is deleted.
  674. USER_DELETE_WITH_COMMENTS_MAX_TIME = 0
  675. [webhook]
  676. ; Hook task queue length, increase if webhook shooting starts hanging
  677. QUEUE_LENGTH = 1000
  678. ; Deliver timeout in seconds
  679. DELIVER_TIMEOUT = 5
  680. ; Allow insecure certification
  681. SKIP_TLS_VERIFY = false
  682. ; Number of history information in each page
  683. PAGING_NUM = 10
  684. ; Proxy server URL, support http://, https//, socks://, blank will follow environment http_proxy/https_proxy
  685. PROXY_URL =
  686. ; Comma separated list of host names requiring proxy. Glob patterns (*) are accepted; use ** to match all hosts.
  687. PROXY_HOSTS =
  688. [mailer]
  689. ENABLED = false
  690. ; Buffer length of channel, keep it as it is if you don't know what it is.
  691. SEND_BUFFER_LEN = 100
  692. ; Prefix displayed before subject in mail
  693. SUBJECT_PREFIX =
  694. ; Mail server
  695. ; Gmail: smtp.gmail.com:587
  696. ; QQ: smtp.qq.com:465
  697. ; Using STARTTLS on port 587 is recommended per RFC 6409.
  698. ; Note, if the port ends with "465", SMTPS will be used.
  699. HOST =
  700. ; Disable HELO operation when hostnames are different.
  701. DISABLE_HELO =
  702. ; Custom hostname for HELO operation, if no value is provided, one is retrieved from system.
  703. HELO_HOSTNAME =
  704. ; 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.
  705. SKIP_VERIFY = false
  706. ; Use client certificate
  707. USE_CERTIFICATE = false
  708. CERT_FILE = custom/mailer/cert.pem
  709. KEY_FILE = custom/mailer/key.pem
  710. ; Should SMTP connect with TLS, (if port ends with 465 TLS will always be used.)
  711. ; If this is false but STARTTLS is supported the connection will be upgraded to TLS opportunistically.
  712. IS_TLS_ENABLED = false
  713. ; Mail from address, RFC 5322. This can be just an email address, or the `"Name" <email@example.com>` format
  714. FROM =
  715. ; Mailer user name and password
  716. ; Please Note: Authentication is only supported when the SMTP server communication is encrypted with TLS (this can be via STARTTLS) or `HOST=localhost`.
  717. USER =
  718. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  719. PASSWD =
  720. ; Send mails as plain text
  721. SEND_AS_PLAIN_TEXT = false
  722. ; Set Mailer Type (either SMTP, sendmail or dummy to just send to the log)
  723. MAILER_TYPE = smtp
  724. ; Specify an alternative sendmail binary
  725. SENDMAIL_PATH = sendmail
  726. ; Specify any extra sendmail arguments
  727. SENDMAIL_ARGS =
  728. ; Timeout for Sendmail
  729. SENDMAIL_TIMEOUT = 5m
  730. [cache]
  731. ; if the cache enabled
  732. ENABLED = true
  733. ; Either "memory", "redis", or "memcache", default is "memory"
  734. ADAPTER = memory
  735. ; For "memory" only, GC interval in seconds, default is 60
  736. INTERVAL = 60
  737. ; For "redis" and "memcache", connection host address
  738. ; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
  739. ; memcache: `127.0.0.1:11211`
  740. HOST =
  741. ; Time to keep items in cache if not used, default is 16 hours.
  742. ; Setting it to 0 disables caching
  743. ITEM_TTL = 16h
  744. ; Last commit cache
  745. [cache.last_commit]
  746. ; if the cache enabled
  747. ENABLED = true
  748. ; Time to keep items in cache if not used, default is 8760 hours.
  749. ; Setting it to 0 disables caching
  750. ITEM_TTL = 8760h
  751. ; Only enable the cache when repository's commits count great than
  752. COMMITS_COUNT = 1000
  753. [session]
  754. ; Either "memory", "file", or "redis", default is "memory"
  755. PROVIDER = memory
  756. ; Provider config options
  757. ; memory: doesn't have any config yet
  758. ; file: session file path, e.g. `data/sessions`
  759. ; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
  760. ; mysql: go-sql-driver/mysql dsn config string, e.g. `root:password@/session_table`
  761. PROVIDER_CONFIG = data/sessions
  762. ; Session cookie name
  763. COOKIE_NAME = i_like_gitea
  764. ; If you use session in https only, default is false
  765. COOKIE_SECURE = false
  766. ; Session GC time interval in seconds, default is 86400 (1 day)
  767. GC_INTERVAL_TIME = 86400
  768. ; Session life time in seconds, default is 86400 (1 day)
  769. SESSION_LIFE_TIME = 86400
  770. ; SameSite settings. Either "none", "lax", or "strict"
  771. SAME_SITE=lax
  772. [picture]
  773. AVATAR_UPLOAD_PATH = data/avatars
  774. REPOSITORY_AVATAR_UPLOAD_PATH = data/repo-avatars
  775. ; How Gitea deals with missing repository avatars
  776. ; none = no avatar will be displayed; random = random avatar will be displayed; image = default image will be used
  777. REPOSITORY_AVATAR_FALLBACK = none
  778. REPOSITORY_AVATAR_FALLBACK_IMAGE = /img/repo_default.png
  779. ; Max Width and Height of uploaded avatars.
  780. ; This is to limit the amount of RAM used when resizing the image.
  781. AVATAR_MAX_WIDTH = 4096
  782. AVATAR_MAX_HEIGHT = 3072
  783. ; Maximum alloved file size for uploaded avatars.
  784. ; This is to limit the amount of RAM used when resizing the image.
  785. AVATAR_MAX_FILE_SIZE = 1048576
  786. ; Chinese users can choose "duoshuo"
  787. ; or a custom avatar source, like: http://cn.gravatar.com/avatar/
  788. GRAVATAR_SOURCE = gravatar
  789. ; This value will always be true in offline mode.
  790. DISABLE_GRAVATAR = false
  791. ; Federated avatar lookup uses DNS to discover avatar associated
  792. ; with emails, see https://www.libravatar.org
  793. ; This value will always be false in offline mode or when Gravatar is disabled.
  794. ENABLE_FEDERATED_AVATAR = false
  795. [attachment]
  796. ; Whether issue and pull request attachments are enabled. Defaults to `true`
  797. ENABLED = true
  798. ; Comma-separated list of allowed file extensions (`.zip`), mime types (`text/plain`) or wildcard type (`image/*`, `audio/*`, `video/*`). Empty value or `*/*` allows all types.
  799. ALLOWED_TYPES = .docx,.gif,.gz,.jpeg,.jpg,.log,.pdf,.png,.pptx,.txt,.xlsx,.zip
  800. ; Max size of each file. Defaults to 4MB
  801. MAX_SIZE = 4
  802. ; Max number of files per upload. Defaults to 5
  803. MAX_FILES = 5
  804. ; Storage type for attachments, `local` for local disk or `minio` for s3 compatible
  805. ; object storage service, default is `local`.
  806. STORAGE_TYPE = local
  807. ; Allows the storage driver to redirect to authenticated URLs to serve files directly
  808. ; Currently, only `minio` is supported.
  809. SERVE_DIRECT = false
  810. ; Path for attachments. Defaults to `data/attachments` only available when STORAGE_TYPE is `local`
  811. PATH = data/attachments
  812. ; Minio endpoint to connect only available when STORAGE_TYPE is `minio`
  813. MINIO_ENDPOINT = localhost:9000
  814. ; Minio accessKeyID to connect only available when STORAGE_TYPE is `minio`
  815. MINIO_ACCESS_KEY_ID =
  816. ; Minio secretAccessKey to connect only available when STORAGE_TYPE is `minio`
  817. MINIO_SECRET_ACCESS_KEY =
  818. ; Minio bucket to store the attachments only available when STORAGE_TYPE is `minio`
  819. MINIO_BUCKET = gitea
  820. ; Minio location to create bucket only available when STORAGE_TYPE is `minio`
  821. MINIO_LOCATION = us-east-1
  822. ; Minio base path on the bucket only available when STORAGE_TYPE is `minio`
  823. MINIO_BASE_PATH = attachments/
  824. ; Minio enabled ssl only available when STORAGE_TYPE is `minio`
  825. MINIO_USE_SSL = false
  826. [time]
  827. ; Specifies the format for fully outputted dates. Defaults to RFC1123
  828. ; Special supported values are ANSIC, UnixDate, RubyDate, RFC822, RFC822Z, RFC850, RFC1123, RFC1123Z, RFC3339, RFC3339Nano, Kitchen, Stamp, StampMilli, StampMicro and StampNano
  829. ; For more information about the format see http://golang.org/pkg/time/#pkg-constants
  830. FORMAT =
  831. ; Location the UI time display i.e. Asia/Shanghai
  832. ; Empty means server's location setting
  833. DEFAULT_UI_LOCATION =
  834. [log]
  835. ROOT_PATH =
  836. ; Either "console", "file", "conn", "smtp" or "database", default is "console"
  837. ; Use comma to separate multiple modes, e.g. "console, file"
  838. MODE = console
  839. ; Buffer length of the channel, keep it as it is if you don't know what it is.
  840. BUFFER_LEN = 10000
  841. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Info"
  842. ROUTER_LOG_LEVEL = Info
  843. ROUTER = console
  844. ENABLE_ACCESS_LOG = false
  845. 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}}"
  846. ACCESS = file
  847. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Trace"
  848. LEVEL = Info
  849. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "None"
  850. STACKTRACE_LEVEL = None
  851. ; Generic log modes
  852. [log.x]
  853. FLAGS = stdflags
  854. EXPRESSION =
  855. PREFIX =
  856. COLORIZE = false
  857. ; For "console" mode only
  858. [log.console]
  859. LEVEL =
  860. STDERR = false
  861. ; For "file" mode only
  862. [log.file]
  863. LEVEL =
  864. ; Set the file_name for the logger. If this is a relative path this
  865. ; will be relative to ROOT_PATH
  866. FILE_NAME =
  867. ; This enables automated log rotate(switch of following options), default is true
  868. LOG_ROTATE = true
  869. ; Max size shift of a single file, default is 28 means 1 << 28, 256MB
  870. MAX_SIZE_SHIFT = 28
  871. ; Segment log daily, default is true
  872. DAILY_ROTATE = true
  873. ; delete the log file after n days, default is 7
  874. MAX_DAYS = 7
  875. ; compress logs with gzip
  876. COMPRESS = true
  877. ; compression level see godoc for compress/gzip
  878. COMPRESSION_LEVEL = -1
  879. ; For "conn" mode only
  880. [log.conn]
  881. LEVEL =
  882. ; Reconnect host for every single message, default is false
  883. RECONNECT_ON_MSG = false
  884. ; Try to reconnect when connection is lost, default is false
  885. RECONNECT = false
  886. ; Either "tcp", "unix" or "udp", default is "tcp"
  887. PROTOCOL = tcp
  888. ; Host address
  889. ADDR =
  890. ; For "smtp" mode only
  891. [log.smtp]
  892. LEVEL =
  893. ; Name displayed in mail title, default is "Diagnostic message from server"
  894. SUBJECT = Diagnostic message from server
  895. ; Mail server
  896. HOST =
  897. ; Mailer user name and password
  898. USER =
  899. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  900. PASSWD =
  901. ; Receivers, can be one or more, e.g. 1@example.com,2@example.com
  902. RECEIVERS =
  903. [cron]
  904. ; Enable running all cron tasks periodically with default settings.
  905. ENABLED = false
  906. ; Run cron tasks when Gitea starts.
  907. RUN_AT_START = false
  908. ; Basic cron tasks - enabled by default
  909. ; Clean up old repository archives
  910. [cron.archive_cleanup]
  911. ; Whether to enable the job
  912. ENABLED = true
  913. ; Whether to always run at least once at start up time (if ENABLED)
  914. RUN_AT_START = true
  915. ; Notice if not success
  916. NO_SUCCESS_NOTICE = false
  917. ; Time interval for job to run
  918. SCHEDULE = @every 24h
  919. ; Archives created more than OLDER_THAN ago are subject to deletion
  920. OLDER_THAN = 24h
  921. ; Update mirrors
  922. [cron.update_mirrors]
  923. SCHEDULE = @every 10m
  924. ; Enable running Update mirrors task periodically.
  925. ENABLED = true
  926. ; Run Update mirrors task when Gitea starts.
  927. RUN_AT_START = false
  928. ; Notice if not success
  929. NO_SUCCESS_NOTICE = true
  930. ; Repository health check
  931. [cron.repo_health_check]
  932. SCHEDULE = @every 24h
  933. ; Enable running Repository health check task periodically.
  934. ENABLED = true
  935. ; Run Repository health check task when Gitea starts.
  936. RUN_AT_START = false
  937. ; Notice if not success
  938. NO_SUCCESS_NOTICE = false
  939. TIMEOUT = 60s
  940. ; Arguments for command 'git fsck', e.g. "--unreachable --tags"
  941. ; see more on http://git-scm.com/docs/git-fsck
  942. ARGS =
  943. ; Check repository statistics
  944. [cron.check_repo_stats]
  945. ; Enable running check repository statistics task periodically.
  946. ENABLED = true
  947. ; Run check repository statistics task when Gitea starts.
  948. RUN_AT_START = true
  949. ; Notice if not success
  950. NO_SUCCESS_NOTICE = false
  951. SCHEDULE = @every 24h
  952. [cron.update_migration_poster_id]
  953. ; Update migrated repositories' issues and comments' posterid, it will always attempt synchronization when the instance starts.
  954. ENABLED = true
  955. ; Update migrated repositories' issues and comments' posterid when starting server (default true)
  956. RUN_AT_START = true
  957. ; Notice if not success
  958. NO_SUCCESS_NOTICE = false
  959. ; Interval as a duration between each synchronization. (default every 24h)
  960. SCHEDULE = @every 24h
  961. ; Synchronize external user data (only LDAP user synchronization is supported)
  962. [cron.sync_external_users]
  963. ENABLED = true
  964. ; Synchronize external user data when starting server (default false)
  965. RUN_AT_START = false
  966. ; Notice if not success
  967. NO_SUCCESS_NOTICE = false
  968. ; Interval as a duration between each synchronization (default every 24h)
  969. SCHEDULE = @every 24h
  970. ; Create new users, update existing user data and disable users that are not in external source anymore (default)
  971. ; or only create new users if UPDATE_EXISTING is set to false
  972. UPDATE_EXISTING = true
  973. ; Clean-up deleted branches
  974. [cron.deleted_branches_cleanup]
  975. ENABLED = true
  976. ; Clean-up deleted branches when starting server (default true)
  977. RUN_AT_START = true
  978. ; Notice if not success
  979. NO_SUCCESS_NOTICE = false
  980. ; Interval as a duration between each synchronization (default every 24h)
  981. SCHEDULE = @every 24h
  982. ; deleted branches than OLDER_THAN ago are subject to deletion
  983. OLDER_THAN = 24h
  984. ; Cleanup hook_task table
  985. [cron.cleanup_hook_task_table]
  986. ; Whether to enable the job
  987. ENABLED = true
  988. ; Whether to always run at start up time (if ENABLED)
  989. RUN_AT_START = false
  990. ; Time interval for job to run
  991. SCHEDULE = @every 24h
  992. ; 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).
  993. CLEANUP_TYPE = OlderThan
  994. ; If CLEANUP_TYPE is set to OlderThan, then any delivered hook_task records older than this expression will be deleted.
  995. OLDER_THAN = 168h
  996. ; 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).
  997. NUMBER_TO_KEEP = 10
  998. ; Extended cron task - not enabled by default
  999. ; Delete all unactivated accounts
  1000. [cron.delete_inactive_accounts]
  1001. ENABLED = false
  1002. RUN_AT_START = false
  1003. NO_SUCCESS_NOTICE = false
  1004. SCHEDULE = @annually
  1005. OLDER_THAN = 168h
  1006. ; Delete all repository archives
  1007. [cron.delete_repo_archives]
  1008. ENABLED = false
  1009. RUN_AT_START = false
  1010. NO_SUCCESS_NOTICE = false
  1011. SCHEDULE = @annually
  1012. ; Garbage collect all repositories
  1013. [cron.git_gc_repos]
  1014. ENABLED = false
  1015. RUN_AT_START = false
  1016. NO_SUCCESS_NOTICE = false
  1017. SCHEDULE = @every 72h
  1018. TIMEOUT = 60s
  1019. ; Arguments for command 'git gc'
  1020. ; The default value is same with [git] -> GC_ARGS
  1021. ARGS =
  1022. ; Update the '.ssh/authorized_keys' file with Gitea SSH keys
  1023. [cron.resync_all_sshkeys]
  1024. ENABLED = false
  1025. RUN_AT_START = false
  1026. NO_SUCCESS_NOTICE = false
  1027. SCHEDULE = @every 72h
  1028. ; Resynchronize pre-receive, update and post-receive hooks of all repositories.
  1029. [cron.resync_all_hooks]
  1030. ENABLED = false
  1031. RUN_AT_START = false
  1032. NO_SUCCESS_NOTICE = false
  1033. SCHEDULE = @every 72h
  1034. ; Reinitialize all missing Git repositories for which records exist
  1035. [cron.reinit_missing_repos]
  1036. ENABLED = false
  1037. RUN_AT_START = false
  1038. NO_SUCCESS_NOTICE = false
  1039. SCHEDULE = @every 72h
  1040. ; Delete all repositories missing their Git files
  1041. [cron.delete_missing_repos]
  1042. ENABLED = false
  1043. RUN_AT_START = false
  1044. NO_SUCCESS_NOTICE = false
  1045. SCHEDULE = @every 72h
  1046. ; Delete generated repository avatars
  1047. [cron.delete_generated_repository_avatars]
  1048. ENABLED = false
  1049. RUN_AT_START = false
  1050. NO_SUCCESS_NOTICE = false
  1051. SCHEDULE = @every 72h
  1052. [git]
  1053. ; The path of git executable. If empty, Gitea searches through the PATH environment.
  1054. PATH =
  1055. ; Disables highlight of added and removed changes
  1056. DISABLE_DIFF_HIGHLIGHT = false
  1057. ; Max number of lines allowed in a single file in diff view
  1058. MAX_GIT_DIFF_LINES = 1000
  1059. ; Max number of allowed characters in a line in diff view
  1060. MAX_GIT_DIFF_LINE_CHARACTERS = 5000
  1061. ; Max number of files shown in diff view
  1062. MAX_GIT_DIFF_FILES = 100
  1063. ; Set the default commits range size
  1064. COMMITS_RANGE_SIZE = 50
  1065. ; Set the default branches range size
  1066. BRANCHES_RANGE_SIZE = 20
  1067. ; Arguments for command 'git gc', e.g. "--aggressive --auto"
  1068. ; see more on http://git-scm.com/docs/git-gc/
  1069. GC_ARGS =
  1070. ; 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
  1071. ENABLE_AUTO_GIT_WIRE_PROTOCOL = true
  1072. ; Respond to pushes to a non-default branch with a URL for creating a Pull Request (if the repository has them enabled)
  1073. PULL_REQUEST_PUSH_MESSAGE = true
  1074. ; Operation timeout in seconds
  1075. [git.timeout]
  1076. DEFAULT = 360
  1077. MIGRATE = 600
  1078. MIRROR = 300
  1079. CLONE = 300
  1080. PULL = 300
  1081. GC = 60
  1082. [mirror]
  1083. ; Default interval as a duration between each check
  1084. DEFAULT_INTERVAL = 8h
  1085. ; Min interval as a duration must be > 1m
  1086. MIN_INTERVAL = 10m
  1087. [api]
  1088. ; Enables Swagger. True or false; default is true.
  1089. ENABLE_SWAGGER = true
  1090. ; Max number of items in a page
  1091. MAX_RESPONSE_ITEMS = 50
  1092. ; Default paging number of api
  1093. DEFAULT_PAGING_NUM = 30
  1094. ; Default and maximum number of items per page for git trees api
  1095. DEFAULT_GIT_TREES_PER_PAGE = 1000
  1096. ; Default size of a blob returned by the blobs API (default is 10MiB)
  1097. DEFAULT_MAX_BLOB_SIZE = 10485760
  1098. [oauth2]
  1099. ; Enables OAuth2 provider
  1100. ENABLE = true
  1101. ; Lifetime of an OAuth2 access token in seconds
  1102. ACCESS_TOKEN_EXPIRATION_TIME = 3600
  1103. ; Lifetime of an OAuth2 refresh token in hours
  1104. REFRESH_TOKEN_EXPIRATION_TIME = 730
  1105. ; Check if refresh token got already used
  1106. INVALIDATE_REFRESH_TOKENS = false
  1107. ; 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
  1108. JWT_SECRET =
  1109. ; Maximum length of oauth2 token/cookie stored on server
  1110. MAX_TOKEN_LENGTH = 32767
  1111. [i18n]
  1112. 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
  1113. 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,한국어
  1114. [U2F]
  1115. ; NOTE: THE DEFAULT VALUES HERE WILL NEED TO BE CHANGED
  1116. ; Two Factor authentication with security keys
  1117. ; https://developers.yubico.com/U2F/App_ID.html
  1118. ;APP_ID = http://localhost:3000/
  1119. ; Comma separated list of trusted facets
  1120. ;TRUSTED_FACETS = http://localhost:3000/
  1121. ; Extension mapping to highlight class
  1122. ; e.g. .toml=ini
  1123. [highlight.mapping]
  1124. [other]
  1125. SHOW_FOOTER_BRANDING = false
  1126. ; Show version information about Gitea and Go in the footer
  1127. SHOW_FOOTER_VERSION = true
  1128. ; Show template execution time in the footer
  1129. SHOW_FOOTER_TEMPLATE_LOAD_TIME = true
  1130. [markup.sanitizer.1]
  1131. ; The following keys can appear once to define a sanitation policy rule.
  1132. ; This section can appear multiple times by adding a unique alphanumeric suffix to define multiple rules.
  1133. ; e.g., [markup.sanitizer.1] -> [markup.sanitizer.2] -> [markup.sanitizer.TeX]
  1134. ;ELEMENT = span
  1135. ;ALLOW_ATTR = class
  1136. ;REGEXP = ^(info|warning|error)$
  1137. [markup.asciidoc]
  1138. ENABLED = false
  1139. ; List of file extensions that should be rendered by an external command
  1140. FILE_EXTENSIONS = .adoc,.asciidoc
  1141. ; External command to render all matching extensions
  1142. RENDER_COMMAND = "asciidoc --out-file=- -"
  1143. ; Don't pass the file on STDIN, pass the filename as argument instead.
  1144. IS_INPUT_FILE = false
  1145. [metrics]
  1146. ; Enables metrics endpoint. True or false; default is false.
  1147. ENABLED = false
  1148. ; If you want to add authorization, specify a token here
  1149. TOKEN =
  1150. [task]
  1151. ; Task queue type, could be `channel` or `redis`.
  1152. QUEUE_TYPE = channel
  1153. ; Task queue length, available only when `QUEUE_TYPE` is `channel`.
  1154. QUEUE_LENGTH = 1000
  1155. ; Task queue connection string, available only when `QUEUE_TYPE` is `redis`.
  1156. ; If there is a password of redis, use `addrs=127.0.0.1:6379 password=123 db=0`.
  1157. QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"
  1158. [migrations]
  1159. ; Max attempts per http/https request on migrations.
  1160. MAX_ATTEMPTS = 3
  1161. ; Backoff time per http/https request retry (seconds)
  1162. RETRY_BACKOFF = 3
  1163. ; Allowed domains for migrating, default is blank. Blank means everything will be allowed.
  1164. ; Multiple domains could be separated by commas.
  1165. ALLOWED_DOMAINS =
  1166. ; Blocklist for migrating, default is blank. Multiple domains could be separated by commas.
  1167. ; When ALLOWED_DOMAINS is not blank, this option will be ignored.
  1168. BLOCKED_DOMAINS =
  1169. ; Allow private addresses defined by RFC 1918, RFC 1122, RFC 4632 and RFC 4291 (false by default)
  1170. ALLOW_LOCALNETWORKS = false
  1171. ; default storage for attachments, lfs and avatars
  1172. [storage]
  1173. ; storage type
  1174. STORAGE_TYPE = local
  1175. ; lfs storage will override storage
  1176. [lfs]
  1177. STORAGE_TYPE = local
  1178. ; customize storage
  1179. ;[storage.my_minio]
  1180. ;STORAGE_TYPE = minio
  1181. ; Minio endpoint to connect only available when STORAGE_TYPE is `minio`
  1182. ;MINIO_ENDPOINT = localhost:9000
  1183. ; Minio accessKeyID to connect only available when STORAGE_TYPE is `minio`
  1184. ;MINIO_ACCESS_KEY_ID =
  1185. ; Minio secretAccessKey to connect only available when STORAGE_TYPE is `minio`
  1186. ;MINIO_SECRET_ACCESS_KEY =
  1187. ; Minio bucket to store the attachments only available when STORAGE_TYPE is `minio`
  1188. ;MINIO_BUCKET = gitea
  1189. ; Minio location to create bucket only available when STORAGE_TYPE is `minio`
  1190. ;MINIO_LOCATION = us-east-1
  1191. ; Minio enabled ssl only available when STORAGE_TYPE is `minio`
  1192. ;MINIO_USE_SSL = false