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.ini.sample 34KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879
  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. ; see https://docs.gitea.io/en-us/config-cheat-sheet/ for additional documentation.
  5. ; App name that shows in every page title
  6. APP_NAME = Gitea: Git with a cup of tea
  7. ; Change it if you run locally
  8. RUN_USER = git
  9. ; Either "dev", "prod" or "test", default is "dev"
  10. RUN_MODE = dev
  11. [repository]
  12. ROOT =
  13. SCRIPT_TYPE = bash
  14. ; Default ANSI charset
  15. ANSI_CHARSET =
  16. ; Force every new repository to be private
  17. FORCE_PRIVATE = false
  18. ; Default privacy setting when creating a new repository, allowed values: last, private, public. Default is last which means the last setting used.
  19. DEFAULT_PRIVATE = last
  20. ; Global limit of repositories per user, applied at creation time. -1 means no limit
  21. MAX_CREATION_LIMIT = -1
  22. ; Mirror sync queue length, increase if mirror syncing starts hanging
  23. MIRROR_QUEUE_LENGTH = 1000
  24. ; Patch test queue length, increase if pull request patch testing starts hanging
  25. PULL_REQUEST_QUEUE_LENGTH = 1000
  26. ; Preferred Licenses to place at the top of the List
  27. ; The name here must match the filename in conf/license or custom/conf/license
  28. PREFERRED_LICENSES = Apache License 2.0,MIT License
  29. ; Disable the ability to interact with repositories using the HTTP protocol
  30. DISABLE_HTTP_GIT = false
  31. ; Value for Access-Control-Allow-Origin header, default is not to present
  32. ; WARNING: This maybe harmful to you website if you do not give it a right value.
  33. ACCESS_CONTROL_ALLOW_ORIGIN =
  34. ; Force ssh:// clone url instead of scp-style uri when default SSH port is used
  35. USE_COMPAT_SSH_URI = false
  36. ; Close issues as long as a commit on any branch marks it as fixed
  37. DEFAULT_CLOSE_ISSUES_VIA_COMMITS_IN_ANY_BRANCH = false
  38. [repository.editor]
  39. ; List of file extensions for which lines should be wrapped in the CodeMirror editor
  40. ; Separate extensions with a comma. To line wrap files without an extension, just put a comma
  41. LINE_WRAP_EXTENSIONS = .txt,.md,.markdown,.mdown,.mkd,
  42. ; Valid file modes that have a preview API associated with them, such as api/v1/markdown
  43. ; Separate the values by commas. The preview tab in edit mode won't be displayed if the file extension doesn't match
  44. PREVIEWABLE_FILE_MODES = markdown
  45. [repository.local]
  46. ; Path for local repository copy. Defaults to `tmp/local-repo`
  47. LOCAL_COPY_PATH = tmp/local-repo
  48. ; Path for local wiki copy. Defaults to `tmp/local-wiki`
  49. LOCAL_WIKI_PATH = tmp/local-wiki
  50. [repository.upload]
  51. ; Whether repository file uploads are enabled. Defaults to `true`
  52. ENABLED = true
  53. ; Path for uploads. Defaults to `data/tmp/uploads` (tmp gets deleted on gitea restart)
  54. TEMP_PATH = data/tmp/uploads
  55. ; One or more allowed types, e.g. image/jpeg|image/png. Nothing means any file type
  56. ALLOWED_TYPES =
  57. ; Max size of each file in megabytes. Defaults to 3MB
  58. FILE_MAX_SIZE = 3
  59. ; Max number of files per upload. Defaults to 5
  60. MAX_FILES = 5
  61. [repository.pull-request]
  62. ; List of prefixes used in Pull Request title to mark them as Work In Progress
  63. WORK_IN_PROGRESS_PREFIXES=WIP:,[WIP]
  64. [repository.issue]
  65. ; List of reasons why a Pull Request or Issue can be locked
  66. LOCK_REASONS=Too heated,Off-topic,Resolved,Spam
  67. [repository.signing]
  68. ; GPG key to use to sign commits, Defaults to the default - that is the value of git config --get user.signingkey
  69. ; run in the context of the RUN_USER
  70. ; Switch to none to stop signing completely
  71. SIGNING_KEY = default
  72. ; If a SIGNING_KEY ID is provided and is not set to default, use the provided Name and Email address as the signer.
  73. ; These should match a publicized name and email address for the key. (When SIGNING_KEY is default these are set to
  74. ; the results of git config --get user.name and git config --get user.email respectively and can only be overrided
  75. ; by setting the SIGNING_KEY ID to the correct ID.)
  76. SIGNING_NAME =
  77. SIGNING_EMAIL =
  78. ; Determines when gitea should sign the initial commit when creating a repository
  79. ; Either:
  80. ; - never
  81. ; - pubkey: only sign if the user has a pubkey
  82. ; - twofa: only sign if the user has logged in with twofa
  83. ; - always
  84. ; options other than none and always can be combined as comma separated list
  85. INITIAL_COMMIT = always
  86. ; Determines when to sign for CRUD actions
  87. ; - as above
  88. ; - parentsigned: requires that the parent commit is signed.
  89. CRUD_ACTIONS = pubkey, twofa, parentsigned
  90. ; Determines when to sign Wiki commits
  91. ; - as above
  92. WIKI = never
  93. ; Determines when to sign on merges
  94. ; - basesigned: require that the parent of commit on the base repo is signed.
  95. ; - commitssigned: require that all the commits in the head branch are signed.
  96. MERGES = pubkey, twofa, basesigned, commitssigned
  97. [cors]
  98. ; More information about CORS can be found here: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS#The_HTTP_response_headers
  99. ; enable cors headers (disabled by default)
  100. ENABLED=false
  101. ; scheme of allowed requests
  102. SCHEME=http
  103. ; list of requesting domains that are allowed
  104. ALLOW_DOMAIN=*
  105. ; allow subdomains of headers listed above to request
  106. ALLOW_SUBDOMAIN=false
  107. ; list of methods allowed to request
  108. METHODS=GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS
  109. ; max time to cache response
  110. MAX_AGE=10m
  111. ; allow request with credentials
  112. ALLOW_CREDENTIALS=false
  113. [ui]
  114. ; Number of repositories that are displayed on one explore page
  115. EXPLORE_PAGING_NUM = 20
  116. ; Number of issues that are displayed on one page
  117. ISSUE_PAGING_NUM = 10
  118. ; Number of maximum commits displayed in one activity feed
  119. FEED_MAX_COMMIT_NUM = 5
  120. ; Number of maximum commits displayed in commit graph.
  121. GRAPH_MAX_COMMIT_NUM = 100
  122. ; Number of line of codes shown for a code comment
  123. CODE_COMMENT_LINES = 4
  124. ; Value of `theme-color` meta tag, used by Android >= 5.0
  125. ; An invalid color like "none" or "disable" will have the default style
  126. ; More info: https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android
  127. THEME_COLOR_META_TAG = `#6cc644`
  128. ; Max size of files to be displayed (default is 8MiB)
  129. MAX_DISPLAY_FILE_SIZE = 8388608
  130. ; Whether the email of the user should be shown in the Explore Users page
  131. SHOW_USER_EMAIL = true
  132. ; Set the default theme for the Gitea install
  133. DEFAULT_THEME = gitea
  134. ; All available themes. Allow users select personalized themes regardless of the value of `DEFAULT_THEME`.
  135. THEMES = gitea,arc-green
  136. ; Whether the full name of the users should be shown where possible. If the full name isn't set, the username will be used.
  137. DEFAULT_SHOW_FULL_NAME = false
  138. ; Whether to search within description at repository search on explore page.
  139. SEARCH_REPO_DESCRIPTION = true
  140. [ui.admin]
  141. ; Number of users that are displayed on one page
  142. USER_PAGING_NUM = 50
  143. ; Number of repos that are displayed on one page
  144. REPO_PAGING_NUM = 50
  145. ; Number of notices that are displayed on one page
  146. NOTICE_PAGING_NUM = 25
  147. ; Number of organizations that are displayed on one page
  148. ORG_PAGING_NUM = 50
  149. [ui.user]
  150. ; Number of repos that are displayed on one page
  151. REPO_PAGING_NUM = 15
  152. [ui.meta]
  153. AUTHOR = Gitea - Git with a cup of tea
  154. DESCRIPTION = Gitea (Git with a cup of tea) is a painless self-hosted Git service written in Go
  155. KEYWORDS = go,git,self-hosted,gitea
  156. [markdown]
  157. ; Enable hard line break extension
  158. ENABLE_HARD_LINE_BREAK = false
  159. ; Comma separated list of custom URL-Schemes that are allowed as links when rendering Markdown
  160. ; for example git,magnet,ftp (more at https://en.wikipedia.org/wiki/List_of_URI_schemes)
  161. ; URLs starting with http and https are always displayed, whatever is put in this entry.
  162. CUSTOM_URL_SCHEMES =
  163. ; List of file extensions that should be rendered/edited as Markdown
  164. ; Separate the extensions with a comma. To render files without any extension as markdown, just put a comma
  165. FILE_EXTENSIONS = .md,.markdown,.mdown,.mkd
  166. [server]
  167. ; The protocol the server listens on. One of 'http', 'https', 'unix' or 'fcgi'.
  168. PROTOCOL = http
  169. DOMAIN = localhost
  170. ROOT_URL = %(PROTOCOL)s://%(DOMAIN)s:%(HTTP_PORT)s/
  171. ; when STATIC_URL_PREFIX is empty it will follow APP_URL
  172. STATIC_URL_PREFIX =
  173. ; The address to listen on. Either a IPv4/IPv6 address or the path to a unix socket.
  174. HTTP_ADDR = 0.0.0.0
  175. HTTP_PORT = 3000
  176. ; If REDIRECT_OTHER_PORT is true, and PROTOCOL is set to https an http server
  177. ; will be started on PORT_TO_REDIRECT and it will redirect plain, non-secure http requests to the main
  178. ; ROOT_URL. Defaults are false for REDIRECT_OTHER_PORT and 80 for
  179. ; PORT_TO_REDIRECT.
  180. REDIRECT_OTHER_PORT = false
  181. PORT_TO_REDIRECT = 80
  182. ; Permission for unix socket
  183. UNIX_SOCKET_PERMISSION = 666
  184. ; Local (DMZ) URL for Gitea workers (such as SSH update) accessing web service.
  185. ; In most cases you do not need to change the default value.
  186. ; Alter it only if your SSH server node is not the same as HTTP node.
  187. ; Do not set this variable if PROTOCOL is set to 'unix'.
  188. LOCAL_ROOT_URL = %(PROTOCOL)s://%(HTTP_ADDR)s:%(HTTP_PORT)s/
  189. ; Disable SSH feature when not available
  190. DISABLE_SSH = false
  191. ; Whether to use the builtin SSH server or not.
  192. START_SSH_SERVER = false
  193. ; Username to use for the builtin SSH server. If blank, then it is the value of RUN_USER.
  194. BUILTIN_SSH_SERVER_USER =
  195. ; Domain name to be exposed in clone URL
  196. SSH_DOMAIN = %(DOMAIN)s
  197. ; The network interface the builtin SSH server should listen on
  198. SSH_LISTEN_HOST =
  199. ; Port number to be exposed in clone URL
  200. SSH_PORT = 22
  201. ; The port number the builtin SSH server should listen on
  202. SSH_LISTEN_PORT = %(SSH_PORT)s
  203. ; Root path of SSH directory, default is '~/.ssh', but you have to use '/home/git/.ssh'.
  204. SSH_ROOT_PATH =
  205. ; Gitea will create a authorized_keys file by default when it is not using the internal ssh server
  206. ; If you intend to use the AuthorizedKeysCommand functionality then you should turn this off.
  207. SSH_CREATE_AUTHORIZED_KEYS_FILE = true
  208. ; For the built-in SSH server, choose the ciphers to support for SSH connections,
  209. ; for system SSH this setting has no effect
  210. SSH_SERVER_CIPHERS = aes128-ctr, aes192-ctr, aes256-ctr, aes128-gcm@openssh.com, arcfour256, arcfour128
  211. ; For the built-in SSH server, choose the key exchange algorithms to support for SSH connections,
  212. ; for system SSH this setting has no effect
  213. 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
  214. ; For the built-in SSH server, choose the MACs to support for SSH connections,
  215. ; for system SSH this setting has no effect
  216. SSH_SERVER_MACS = hmac-sha2-256-etm@openssh.com, hmac-sha2-256, hmac-sha1, hmac-sha1-96
  217. ; Directory to create temporary files in when testing public keys using ssh-keygen,
  218. ; default is the system temporary directory.
  219. SSH_KEY_TEST_PATH =
  220. ; Path to ssh-keygen, default is 'ssh-keygen' which means the shell is responsible for finding out which one to call.
  221. SSH_KEYGEN_PATH = ssh-keygen
  222. ; Enable SSH Authorized Key Backup when rewriting all keys, default is true
  223. SSH_BACKUP_AUTHORIZED_KEYS = true
  224. ; Enable exposure of SSH clone URL to anonymous visitors, default is false
  225. SSH_EXPOSE_ANONYMOUS = false
  226. ; Indicate whether to check minimum key size with corresponding type
  227. MINIMUM_KEY_SIZE_CHECK = false
  228. ; Disable CDN even in "prod" mode
  229. OFFLINE_MODE = false
  230. DISABLE_ROUTER_LOG = false
  231. ; Generate steps:
  232. ; $ ./gitea cert -ca=true -duration=8760h0m0s -host=myhost.example.com
  233. ;
  234. ; Or from a .pfx file exported from the Windows certificate store (do
  235. ; not forget to export the private key):
  236. ; $ openssl pkcs12 -in cert.pfx -out cert.pem -nokeys
  237. ; $ openssl pkcs12 -in cert.pfx -out key.pem -nocerts -nodes
  238. CERT_FILE = custom/https/cert.pem
  239. KEY_FILE = custom/https/key.pem
  240. ; Root directory containing templates and static files.
  241. ; default is the path where Gitea is executed
  242. STATIC_ROOT_PATH =
  243. ; Default path for App data
  244. APP_DATA_PATH = data
  245. ; Application level GZIP support
  246. ENABLE_GZIP = false
  247. ; Application profiling (memory and cpu)
  248. ; For "web" command it listens on localhost:6060
  249. ; For "serve" command it dumps to disk at PPROF_DATA_PATH as (cpuprofile|memprofile)_<username>_<temporary id>
  250. ENABLE_PPROF = false
  251. ; PPROF_DATA_PATH, use an absolute path when you start gitea as service
  252. PPROF_DATA_PATH = data/tmp/pprof
  253. ; Landing page, can be "home", "explore", or "organizations"
  254. LANDING_PAGE = home
  255. ; Enables git-lfs support. true or false, default is false.
  256. LFS_START_SERVER = false
  257. ; Where your lfs files reside, default is data/lfs.
  258. LFS_CONTENT_PATH = data/lfs
  259. ; LFS authentication secret, change this yourself
  260. LFS_JWT_SECRET =
  261. ; LFS authentication validity period (in time.Duration), pushes taking longer than this may fail.
  262. LFS_HTTP_AUTH_EXPIRY = 20m
  263. ; Allow graceful restarts using SIGHUP to fork
  264. ALLOW_GRACEFUL_RESTARTS = true
  265. ; After a restart the parent will finish ongoing requests before
  266. ; shutting down. Force shutdown if this process takes longer than this delay.
  267. ; set to a negative value to disable
  268. GRACEFUL_HAMMER_TIME = 60s
  269. ; Static resources, includes resources on custom/, public/ and all uploaded avatars web browser cache time, default is 6h
  270. STATIC_CACHE_TIME = 6h
  271. ; Define allowed algorithms and their minimum key length (use -1 to disable a type)
  272. [ssh.minimum_key_sizes]
  273. ED25519 = 256
  274. ECDSA = 256
  275. RSA = 2048
  276. DSA = 1024
  277. [database]
  278. ; Either "mysql", "postgres", "mssql" or "sqlite3", it's your choice
  279. DB_TYPE = mysql
  280. HOST = 127.0.0.1:3306
  281. NAME = gitea
  282. USER = root
  283. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  284. PASSWD =
  285. ; For Postgres, either "disable" (default), "require", or "verify-full"
  286. ; For MySQL, either "false" (default), "true", or "skip-verify"
  287. SSL_MODE = disable
  288. ; For MySQL only, either "utf8" or "utf8mb4", default is "utf8".
  289. ; NOTICE: for "utf8mb4" you must use MySQL InnoDB > 5.6. Gitea is unable to check this.
  290. CHARSET = utf8
  291. ; For "sqlite3" and "tidb", use an absolute path when you start gitea as service
  292. PATH = data/gitea.db
  293. ; For "sqlite3" only. Query timeout
  294. SQLITE_TIMEOUT = 500
  295. ; For iterate buffer, default is 50
  296. ITERATE_BUFFER_SIZE = 50
  297. ; Show the database generated SQL
  298. LOG_SQL = true
  299. ; Maximum number of DB Connect retries
  300. DB_RETRIES = 10
  301. ; Backoff time per DB retry (time.Duration)
  302. DB_RETRY_BACKOFF = 3s
  303. ; Max idle database connections on connnection pool, default is 2
  304. MAX_IDLE_CONNS = 2
  305. ; Database connection max life time, default is 0 or 3s mysql (See #6804 & #7071 for reasoning)
  306. CONN_MAX_LIFETIME = 3s
  307. ; Database maximum number of open connections, default is 0 meaning no maximum
  308. MAX_OPEN_CONNS = 0
  309. [indexer]
  310. ; Issue indexer type, currently support: bleve or db, default is bleve
  311. ISSUE_INDEXER_TYPE = bleve
  312. ; Issue indexer storage path, available when ISSUE_INDEXER_TYPE is bleve
  313. ISSUE_INDEXER_PATH = indexers/issues.bleve
  314. ; Issue indexer queue, currently support: channel, levelqueue or redis, default is levelqueue
  315. ISSUE_INDEXER_QUEUE_TYPE = levelqueue
  316. ; When ISSUE_INDEXER_QUEUE_TYPE is levelqueue, this will be the queue will be saved path,
  317. ; default is indexers/issues.queue
  318. ISSUE_INDEXER_QUEUE_DIR = indexers/issues.queue
  319. ; When `ISSUE_INDEXER_QUEUE_TYPE` is `redis`, this will store the redis connection string.
  320. ISSUE_INDEXER_QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"
  321. ; Batch queue number, default is 20
  322. ISSUE_INDEXER_QUEUE_BATCH_NUMBER = 20
  323. ; Timeout the indexer if it takes longer than this to start.
  324. ; Set to zero to disable timeout.
  325. STARTUP_TIMEOUT=30s
  326. ; repo indexer by default disabled, since it uses a lot of disk space
  327. REPO_INDEXER_ENABLED = false
  328. REPO_INDEXER_PATH = indexers/repos.bleve
  329. UPDATE_BUFFER_LEN = 20
  330. MAX_FILE_SIZE = 1048576
  331. ; A comma separated list of glob patterns (see https://github.com/gobwas/glob) to include
  332. ; in the index; default is empty
  333. REPO_INDEXER_INCLUDE =
  334. ; A comma separated list of glob patterns to exclude from the index; ; default is empty
  335. REPO_INDEXER_EXCLUDE =
  336. [admin]
  337. ; Disallow regular (non-admin) users from creating organizations.
  338. DISABLE_REGULAR_ORG_CREATION = false
  339. ; Default configuration for email notifications for users (user configurable). Options: enabled, onmention, disabled
  340. DEFAULT_EMAIL_NOTIFICATIONS = enabled
  341. [security]
  342. ; Whether the installer is disabled
  343. INSTALL_LOCK = false
  344. ; !!CHANGE THIS TO KEEP YOUR USER DATA SAFE!!
  345. SECRET_KEY = !#@FDEWREWR&*(
  346. ; How long to remember that a user is logged in before requiring relogin (in days)
  347. LOGIN_REMEMBER_DAYS = 7
  348. COOKIE_USERNAME = gitea_awesome
  349. COOKIE_REMEMBER_NAME = gitea_incredible
  350. ; Reverse proxy authentication header name of user name
  351. REVERSE_PROXY_AUTHENTICATION_USER = X-WEBAUTH-USER
  352. REVERSE_PROXY_AUTHENTICATION_EMAIL = X-WEBAUTH-EMAIL
  353. ; The minimum password length for new Users
  354. MIN_PASSWORD_LENGTH = 6
  355. ; Set to true to allow users to import local server paths
  356. IMPORT_LOCAL_PATHS = false
  357. ; Set to true to prevent all users (including admin) from creating custom git hooks
  358. DISABLE_GIT_HOOKS = false
  359. ;Comma separated list of character classes required to pass minimum complexity.
  360. ;If left empty or no valid values are specified, the default values ("lower,upper,digit,spec") will be used.
  361. ;Use "off" to disable checking.
  362. PASSWORD_COMPLEXITY = lower,upper,digit,spec
  363. ; Password Hash algorithm, either "pbkdf2", "argon2", "scrypt" or "bcrypt"
  364. PASSWORD_HASH_ALGO = pbkdf2
  365. ; Set false to allow JavaScript to read CSRF cookie
  366. CSRF_COOKIE_HTTP_ONLY = true
  367. [openid]
  368. ;
  369. ; OpenID is an open, standard and decentralized authentication protocol.
  370. ; Your identity is the address of a webpage you provide, which describes
  371. ; how to prove you are in control of that page.
  372. ;
  373. ; For more info: https://en.wikipedia.org/wiki/OpenID
  374. ;
  375. ; Current implementation supports OpenID-2.0
  376. ;
  377. ; Tested to work providers at the time of writing:
  378. ; - Any GNUSocial node (your.hostname.tld/username)
  379. ; - Any SimpleID provider (http://simpleid.koinic.net)
  380. ; - http://openid.org.cn/
  381. ; - openid.stackexchange.com
  382. ; - login.launchpad.net
  383. ; - <username>.livejournal.com
  384. ;
  385. ; Whether to allow signin in via OpenID
  386. ENABLE_OPENID_SIGNIN = true
  387. ; Whether to allow registering via OpenID
  388. ; Do not include to rely on rhw DISABLE_REGISTRATION setting
  389. ;ENABLE_OPENID_SIGNUP = true
  390. ; Allowed URI patterns (POSIX regexp).
  391. ; Space separated.
  392. ; Only these would be allowed if non-blank.
  393. ; Example value: trusted.domain.org trusted.domain.net
  394. WHITELISTED_URIS =
  395. ; Forbidden URI patterns (POSIX regexp).
  396. ; Space separated.
  397. ; Only used if WHITELISTED_URIS is blank.
  398. ; Example value: loadaverage.org/badguy stackexchange.com/.*spammer
  399. BLACKLISTED_URIS =
  400. [service]
  401. ; Time limit to confirm account/email registration
  402. ACTIVE_CODE_LIVE_MINUTES = 180
  403. ; Time limit to perform the reset of a forgotten password
  404. RESET_PASSWD_CODE_LIVE_MINUTES = 180
  405. ; Whether a new user needs to confirm their email when registering.
  406. REGISTER_EMAIL_CONFIRM = false
  407. ; List of domain names that are allowed to be used to register on a Gitea instance
  408. ; gitea.io,example.com
  409. EMAIL_DOMAIN_WHITELIST=
  410. ; Disallow registration, only allow admins to create accounts.
  411. DISABLE_REGISTRATION = false
  412. ; Allow registration only using third-party services, it works only when DISABLE_REGISTRATION is false
  413. ALLOW_ONLY_EXTERNAL_REGISTRATION = false
  414. ; User must sign in to view anything.
  415. REQUIRE_SIGNIN_VIEW = false
  416. ; Mail notification
  417. ENABLE_NOTIFY_MAIL = false
  418. ; This setting enables gitea to be signed in with HTTP BASIC Authentication using the user's password
  419. ; If you set this to false you will not be able to access the tokens endpoints on the API with your password
  420. ; Please note that setting this to false will not disable OAuth Basic or Basic authentication using a token
  421. ENABLE_BASIC_AUTHENTICATION = true
  422. ; More detail: https://github.com/gogits/gogs/issues/165
  423. ENABLE_REVERSE_PROXY_AUTHENTICATION = false
  424. ENABLE_REVERSE_PROXY_AUTO_REGISTRATION = false
  425. ENABLE_REVERSE_PROXY_EMAIL = false
  426. ; Enable captcha validation for registration
  427. ENABLE_CAPTCHA = false
  428. ; Type of captcha you want to use. Options: image, recaptcha
  429. CAPTCHA_TYPE = image
  430. ; Enable recaptcha to use Google's recaptcha service
  431. ; Go to https://www.google.com/recaptcha/admin to sign up for a key
  432. RECAPTCHA_SECRET =
  433. RECAPTCHA_SITEKEY =
  434. ; Change this to use recaptcha.net or other recaptcha service
  435. RECAPTCHA_URL = https://www.google.com/recaptcha/
  436. ; Default value for KeepEmailPrivate
  437. ; Each new user will get the value of this setting copied into their profile
  438. DEFAULT_KEEP_EMAIL_PRIVATE = false
  439. ; Default value for AllowCreateOrganization
  440. ; Every new user will have rights set to create organizations depending on this setting
  441. DEFAULT_ALLOW_CREATE_ORGANIZATION = true
  442. ; Either "public", "limited" or "private", default is "public"
  443. ; Limited is for signed user only
  444. ; Private is only for member of the organization
  445. ; Public is for everyone
  446. DEFAULT_ORG_VISIBILITY = public
  447. ; Default value for DefaultOrgMemberVisible
  448. ; True will make the membership of the users visible when added to the organisation
  449. DEFAULT_ORG_MEMBER_VISIBLE = false
  450. ; Default value for EnableDependencies
  451. ; Repositories will use dependencies by default depending on this setting
  452. DEFAULT_ENABLE_DEPENDENCIES = true
  453. ; Enable heatmap on users profiles.
  454. ENABLE_USER_HEATMAP = true
  455. ; Enable Timetracking
  456. ENABLE_TIMETRACKING = true
  457. ; Default value for EnableTimetracking
  458. ; Repositories will use timetracking by default depending on this setting
  459. DEFAULT_ENABLE_TIMETRACKING = true
  460. ; Default value for AllowOnlyContributorsToTrackTime
  461. ; Only users with write permissions can track time if this is true
  462. DEFAULT_ALLOW_ONLY_CONTRIBUTORS_TO_TRACK_TIME = true
  463. ; Default value for the domain part of the user's email address in the git log
  464. ; if he has set KeepEmailPrivate to true. The user's email will be replaced with a
  465. ; concatenation of the user name in lower case, "@" and NO_REPLY_ADDRESS.
  466. NO_REPLY_ADDRESS = noreply.example.org
  467. ; Show Registration button
  468. SHOW_REGISTRATION_BUTTON = true
  469. ; Default value for AutoWatchNewRepos
  470. ; When adding a repo to a team or creating a new repo all team members will watch the
  471. ; repo automatically if enabled
  472. AUTO_WATCH_NEW_REPOS = true
  473. [webhook]
  474. ; Hook task queue length, increase if webhook shooting starts hanging
  475. QUEUE_LENGTH = 1000
  476. ; Deliver timeout in seconds
  477. DELIVER_TIMEOUT = 5
  478. ; Allow insecure certification
  479. SKIP_TLS_VERIFY = false
  480. ; Number of history information in each page
  481. PAGING_NUM = 10
  482. [mailer]
  483. ENABLED = false
  484. ; Buffer length of channel, keep it as it is if you don't know what it is.
  485. SEND_BUFFER_LEN = 100
  486. ; Prefix displayed before subject in mail
  487. SUBJECT_PREFIX =
  488. ; Mail server
  489. ; Gmail: smtp.gmail.com:587
  490. ; QQ: smtp.qq.com:465
  491. ; Note, if the port ends with "465", SMTPS will be used. Using STARTTLS on port 587 is recommended per RFC 6409. If the server supports STARTTLS it will always be used.
  492. HOST =
  493. ; Disable HELO operation when hostnames are different.
  494. DISABLE_HELO =
  495. ; Custom hostname for HELO operation, if no value is provided, one is retrieved from system.
  496. HELO_HOSTNAME =
  497. ; Do not verify the certificate of the server. Only use this for self-signed certificates
  498. SKIP_VERIFY =
  499. ; Use client certificate
  500. USE_CERTIFICATE = false
  501. CERT_FILE = custom/mailer/cert.pem
  502. KEY_FILE = custom/mailer/key.pem
  503. ; Should SMTP connection use TLS
  504. IS_TLS_ENABLED = false
  505. ; Mail from address, RFC 5322. This can be just an email address, or the `"Name" <email@example.com>` format
  506. FROM =
  507. ; Mailer user name and password
  508. USER =
  509. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  510. PASSWD =
  511. ; Send mails as plain text
  512. SEND_AS_PLAIN_TEXT = false
  513. ; Set Mailer Type (either SMTP, sendmail or dummy to just send to the log)
  514. MAILER_TYPE = smtp
  515. ; Specify an alternative sendmail binary
  516. SENDMAIL_PATH = sendmail
  517. ; Specify any extra sendmail arguments
  518. SENDMAIL_ARGS =
  519. [cache]
  520. ; Either "memory", "redis", or "memcache", default is "memory"
  521. ADAPTER = memory
  522. ; For "memory" only, GC interval in seconds, default is 60
  523. INTERVAL = 60
  524. ; For "redis" and "memcache", connection host address
  525. ; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
  526. ; memcache: `127.0.0.1:11211`
  527. HOST =
  528. ; Time to keep items in cache if not used, default is 16 hours.
  529. ; Setting it to 0 disables caching
  530. ITEM_TTL = 16h
  531. [session]
  532. ; Either "memory", "file", or "redis", default is "memory"
  533. PROVIDER = memory
  534. ; Provider config options
  535. ; memory: doesn't have any config yet
  536. ; file: session file path, e.g. `data/sessions`
  537. ; redis: network=tcp,addr=:6379,password=macaron,db=0,pool_size=100,idle_timeout=180
  538. ; mysql: go-sql-driver/mysql dsn config string, e.g. `root:password@/session_table`
  539. PROVIDER_CONFIG = data/sessions
  540. ; Session cookie name
  541. COOKIE_NAME = i_like_gitea
  542. ; If you use session in https only, default is false
  543. COOKIE_SECURE = false
  544. ; Enable set cookie, default is true
  545. ENABLE_SET_COOKIE = true
  546. ; Session GC time interval in seconds, default is 86400 (1 day)
  547. GC_INTERVAL_TIME = 86400
  548. ; Session life time in seconds, default is 86400 (1 day)
  549. SESSION_LIFE_TIME = 86400
  550. [picture]
  551. AVATAR_UPLOAD_PATH = data/avatars
  552. REPOSITORY_AVATAR_UPLOAD_PATH = data/repo-avatars
  553. ; How Gitea deals with missing repository avatars
  554. ; none = no avatar will be displayed; random = random avatar will be displayed; image = default image will be used
  555. REPOSITORY_AVATAR_FALLBACK = none
  556. REPOSITORY_AVATAR_FALLBACK_IMAGE = /img/repo_default.png
  557. ; Max Width and Height of uploaded avatars.
  558. ; This is to limit the amount of RAM used when resizing the image.
  559. AVATAR_MAX_WIDTH = 4096
  560. AVATAR_MAX_HEIGHT = 3072
  561. ; Maximum alloved file size for uploaded avatars.
  562. ; This is to limit the amount of RAM used when resizing the image.
  563. AVATAR_MAX_FILE_SIZE = 1048576
  564. ; Chinese users can choose "duoshuo"
  565. ; or a custom avatar source, like: http://cn.gravatar.com/avatar/
  566. GRAVATAR_SOURCE = gravatar
  567. ; This value will always be true in offline mode.
  568. DISABLE_GRAVATAR = false
  569. ; Federated avatar lookup uses DNS to discover avatar associated
  570. ; with emails, see https://www.libravatar.org
  571. ; This value will always be false in offline mode or when Gravatar is disabled.
  572. ENABLE_FEDERATED_AVATAR = false
  573. [attachment]
  574. ; Whether attachments are enabled. Defaults to `true`
  575. ENABLED = true
  576. ; Path for attachments. Defaults to `data/attachments`
  577. PATH = data/attachments
  578. ; One or more allowed types, e.g. image/jpeg|image/png
  579. ALLOWED_TYPES = image/jpeg|image/png|application/zip|application/gzip
  580. ; Max size of each file. Defaults to 4MB
  581. MAX_SIZE = 4
  582. ; Max number of files per upload. Defaults to 5
  583. MAX_FILES = 5
  584. [time]
  585. ; Specifies the format for fully outputted dates. Defaults to RFC1123
  586. ; Special supported values are ANSIC, UnixDate, RubyDate, RFC822, RFC822Z, RFC850, RFC1123, RFC1123Z, RFC3339, RFC3339Nano, Kitchen, Stamp, StampMilli, StampMicro and StampNano
  587. ; For more information about the format see http://golang.org/pkg/time/#pkg-constants
  588. FORMAT =
  589. ; Location the UI time display i.e. Asia/Shanghai
  590. ; Empty means server's location setting
  591. DEFAULT_UI_LOCATION =
  592. [log]
  593. ROOT_PATH =
  594. ; Either "console", "file", "conn", "smtp" or "database", default is "console"
  595. ; Use comma to separate multiple modes, e.g. "console, file"
  596. MODE = console
  597. ; Buffer length of the channel, keep it as it is if you don't know what it is.
  598. BUFFER_LEN = 10000
  599. REDIRECT_MACARON_LOG = false
  600. MACARON = file
  601. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Info"
  602. ROUTER_LOG_LEVEL = Info
  603. ROUTER = console
  604. ENABLE_ACCESS_LOG = false
  605. ACCESS_LOG_TEMPLATE = {{.Ctx.RemoteAddr}} - {{.Identity}} {{.Start.Format "[02/Jan/2006:15:04:05 -0700]" }} "{{.Ctx.Req.Method}} {{.Ctx.Req.RequestURI}} {{.Ctx.Req.Proto}}" {{.ResponseWriter.Status}} {{.ResponseWriter.Size}} "{{.Ctx.Req.Referer}}\" \"{{.Ctx.Req.UserAgent}}"
  606. ACCESS = file
  607. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "Trace"
  608. LEVEL = Info
  609. ; Either "Trace", "Debug", "Info", "Warn", "Error", "Critical", default is "None"
  610. STACKTRACE_LEVEL = None
  611. ; Generic log modes
  612. [log.x]
  613. FLAGS = stdflags
  614. EXPRESSION =
  615. PREFIX =
  616. COLORIZE = false
  617. ; For "console" mode only
  618. [log.console]
  619. LEVEL =
  620. STDERR = false
  621. ; For "file" mode only
  622. [log.file]
  623. LEVEL =
  624. ; Set the file_name for the logger. If this is a relative path this
  625. ; will be relative to ROOT_PATH
  626. FILE_NAME =
  627. ; This enables automated log rotate(switch of following options), default is true
  628. LOG_ROTATE = true
  629. ; Max number of lines in a single file, default is 1000000
  630. MAX_LINES = 1000000
  631. ; Max size shift of a single file, default is 28 means 1 << 28, 256MB
  632. MAX_SIZE_SHIFT = 28
  633. ; Segment log daily, default is true
  634. DAILY_ROTATE = true
  635. ; delete the log file after n days, default is 7
  636. MAX_DAYS = 7
  637. ; compress logs with gzip
  638. COMPRESS = true
  639. ; compression level see godoc for compress/gzip
  640. COMPRESSION_LEVEL = -1
  641. ; For "conn" mode only
  642. [log.conn]
  643. LEVEL =
  644. ; Reconnect host for every single message, default is false
  645. RECONNECT_ON_MSG = false
  646. ; Try to reconnect when connection is lost, default is false
  647. RECONNECT = false
  648. ; Either "tcp", "unix" or "udp", default is "tcp"
  649. PROTOCOL = tcp
  650. ; Host address
  651. ADDR =
  652. ; For "smtp" mode only
  653. [log.smtp]
  654. LEVEL =
  655. ; Name displayed in mail title, default is "Diagnostic message from server"
  656. SUBJECT = Diagnostic message from server
  657. ; Mail server
  658. HOST =
  659. ; Mailer user name and password
  660. USER =
  661. ; Use PASSWD = `your password` for quoting if you use special characters in the password.
  662. PASSWD =
  663. ; Receivers, can be one or more, e.g. 1@example.com,2@example.com
  664. RECEIVERS =
  665. [cron]
  666. ; Enable running cron tasks periodically.
  667. ENABLED = true
  668. ; Run cron tasks when Gitea starts.
  669. RUN_AT_START = false
  670. ; Update mirrors
  671. [cron.update_mirrors]
  672. SCHEDULE = @every 10m
  673. ; Repository health check
  674. [cron.repo_health_check]
  675. SCHEDULE = @every 24h
  676. TIMEOUT = 60s
  677. ; Arguments for command 'git fsck', e.g. "--unreachable --tags"
  678. ; see more on http://git-scm.com/docs/git-fsck
  679. ARGS =
  680. ; Check repository statistics
  681. [cron.check_repo_stats]
  682. RUN_AT_START = true
  683. SCHEDULE = @every 24h
  684. ; Clean up old repository archives
  685. [cron.archive_cleanup]
  686. ; Whether to enable the job
  687. ENABLED = true
  688. ; Whether to always run at least once at start up time (if ENABLED)
  689. RUN_AT_START = true
  690. ; Time interval for job to run
  691. SCHEDULE = @every 24h
  692. ; Archives created more than OLDER_THAN ago are subject to deletion
  693. OLDER_THAN = 24h
  694. ; Synchronize external user data (only LDAP user synchronization is supported)
  695. [cron.sync_external_users]
  696. ; Synchronize external user data when starting server (default false)
  697. RUN_AT_START = false
  698. ; Interval as a duration between each synchronization (default every 24h)
  699. SCHEDULE = @every 24h
  700. ; Create new users, update existing user data and disable users that are not in external source anymore (default)
  701. ; or only create new users if UPDATE_EXISTING is set to false
  702. UPDATE_EXISTING = true
  703. ; Update migrated repositories' issues and comments' posterid, it will always attempt synchronization when the instance starts.
  704. [cron.update_migration_post_id]
  705. ; Interval as a duration between each synchronization. (default every 24h)
  706. SCHEDULE = @every 24h
  707. [git]
  708. ; The path of git executable. If empty, Gitea searches through the PATH environment.
  709. PATH =
  710. ; Disables highlight of added and removed changes
  711. DISABLE_DIFF_HIGHLIGHT = false
  712. ; Max number of lines allowed in a single file in diff view
  713. MAX_GIT_DIFF_LINES = 1000
  714. ; Max number of allowed characters in a line in diff view
  715. MAX_GIT_DIFF_LINE_CHARACTERS = 5000
  716. ; Max number of files shown in diff view
  717. MAX_GIT_DIFF_FILES = 100
  718. ; Arguments for command 'git gc', e.g. "--aggressive --auto"
  719. ; see more on http://git-scm.com/docs/git-gc/
  720. GC_ARGS =
  721. ; 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
  722. EnableAutoGitWireProtocol = true
  723. ; Operation timeout in seconds
  724. [git.timeout]
  725. DEFAULT = 360
  726. MIGRATE = 600
  727. MIRROR = 300
  728. CLONE = 300
  729. PULL = 300
  730. GC = 60
  731. [mirror]
  732. ; Default interval as a duration between each check
  733. DEFAULT_INTERVAL = 8h
  734. ; Min interval as a duration must be > 1m
  735. MIN_INTERVAL = 10m
  736. [api]
  737. ; Enables Swagger. True or false; default is true.
  738. ENABLE_SWAGGER = true
  739. ; Max number of items in a page
  740. MAX_RESPONSE_ITEMS = 50
  741. ; Default paging number of api
  742. DEFAULT_PAGING_NUM = 30
  743. ; Default and maximum number of items per page for git trees api
  744. DEFAULT_GIT_TREES_PER_PAGE = 1000
  745. ; Default size of a blob returned by the blobs API (default is 10MiB)
  746. DEFAULT_MAX_BLOB_SIZE = 10485760
  747. [oauth2]
  748. ; Enables OAuth2 provider
  749. ENABLE = true
  750. ; Lifetime of an OAuth2 access token in seconds
  751. ACCESS_TOKEN_EXPIRATION_TIME=3600
  752. ; Lifetime of an OAuth2 access token in hours
  753. REFRESH_TOKEN_EXPIRATION_TIME=730
  754. ; Check if refresh token got already used
  755. INVALIDATE_REFRESH_TOKENS=false
  756. ; OAuth2 authentication secret for access and refresh tokens, change this to a unique string.
  757. JWT_SECRET=Bk0yK7Y9g_p56v86KaHqjSbxvNvu3SbKoOdOt2ZcXvU
  758. [i18n]
  759. 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,pl-PL,bg-BG,it-IT,fi-FI,tr-TR,cs-CZ,sr-SP,sv-SE,ko-KR
  760. NAMES = English,简体中文,繁體中文(香港),繁體中文(台灣),Deutsch,français,Nederlands,latviešu,русский,Українська,日本語,español,português do Brasil,polski,български,italiano,suomi,Türkçe,čeština,српски,svenska,한국어
  761. ; Used for datetimepicker
  762. [i18n.datelang]
  763. en-US = en
  764. zh-CN = zh
  765. zh-HK = zh-HK
  766. zh-TW = zh-TW
  767. de-DE = de
  768. fr-FR = fr
  769. nl-NL = nl
  770. lv-LV = lv
  771. ru-RU = ru
  772. uk-UA = uk
  773. ja-JP = ja
  774. es-ES = es
  775. pt-BR = pt-BR
  776. pl-PL = pl
  777. bg-BG = bg
  778. it-IT = it
  779. fi-FI = fi
  780. tr-TR = tr
  781. cs-CZ = cs-CZ
  782. sr-SP = sr
  783. sv-SE = sv
  784. ko-KR = ko
  785. [U2F]
  786. ; NOTE: THE DEFAULT VALUES HERE WILL NEED TO BE CHANGED
  787. ; Two Factor authentication with security keys
  788. ; https://developers.yubico.com/U2F/App_ID.html
  789. ;APP_ID = http://localhost:3000/
  790. ; Comma seperated list of trusted facets
  791. ;TRUSTED_FACETS = http://localhost:3000/
  792. ; Extension mapping to highlight class
  793. ; e.g. .toml=ini
  794. [highlight.mapping]
  795. [other]
  796. SHOW_FOOTER_BRANDING = false
  797. ; Show version information about Gitea and Go in the footer
  798. SHOW_FOOTER_VERSION = true
  799. ; Show template execution time in the footer
  800. SHOW_FOOTER_TEMPLATE_LOAD_TIME = true
  801. [markup.asciidoc]
  802. ENABLED = false
  803. ; List of file extensions that should be rendered by an external command
  804. FILE_EXTENSIONS = .adoc,.asciidoc
  805. ; External command to render all matching extensions
  806. RENDER_COMMAND = "asciidoc --out-file=- -"
  807. ; Don't pass the file on STDIN, pass the filename as argument instead.
  808. IS_INPUT_FILE = false
  809. [metrics]
  810. ; Enables metrics endpoint. True or false; default is false.
  811. ENABLED = false
  812. ; If you want to add authorization, specify a token here
  813. TOKEN =
  814. [task]
  815. ; Task queue type, could be `channel` or `redis`.
  816. QUEUE_TYPE = channel
  817. ; Task queue length, available only when `QUEUE_TYPE` is `channel`.
  818. QUEUE_LENGTH = 1000
  819. ; Task queue connection string, available only when `QUEUE_TYPE` is `redis`.
  820. ; If there is a password of redis, use `addrs=127.0.0.1:6379 password=123 db=0`.
  821. QUEUE_CONN_STR = "addrs=127.0.0.1:6379 db=0"