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.

gitblit.properties 56KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716
  1. #
  2. # Gitblit Settings
  3. #
  4. # This settings file supports parameterization from the command-line for the
  5. # following command-line parameters:
  6. #
  7. # --baseFolder ${baseFolder} SINCE 1.2.1
  8. #
  9. # Settings that support ${baseFolder} parameter substitution are indicated with the
  10. # BASEFOLDER attribute. If the --baseFolder argument is unspecified, ${baseFolder}
  11. # and it's trailing / will be discarded from the setting value leaving a relative
  12. # path that is equivalent to pre-1.2.1 releases.
  13. #
  14. # e.g. "${baseFolder}/git" becomes "git", if --baseFolder is unspecified
  15. #
  16. # Git Servlet Settings
  17. #
  18. # Base folder for repositories.
  19. # This folder may contain bare and non-bare repositories but Gitblit will only
  20. # allow you to push to bare repositories.
  21. # Use forward slashes even on Windows!!
  22. # e.g. c:/gitrepos
  23. #
  24. # SINCE 0.5.0
  25. # RESTART REQUIRED
  26. # BASEFOLDER
  27. git.repositoriesFolder = ${baseFolder}/git
  28. # Build the available repository list at startup and cache this list for reuse.
  29. # This reduces disk io when presenting the repositories page, responding to rpcs,
  30. # etc, but it means that Gitblit will not automatically identify repositories
  31. # added or deleted by external tools.
  32. #
  33. # For this case you can use curl, wget, etc to issue an rpc request to clear the
  34. # cache (e.g. https://localhost/rpc?req=CLEAR_REPOSITORY_CACHE)
  35. #
  36. # SINCE 1.1.0
  37. git.cacheRepositoryList = true
  38. # Search the repositories folder subfolders for other repositories.
  39. # Repositories MAY NOT be nested (i.e. one repository within another)
  40. # but they may be grouped together in subfolders.
  41. # e.g. c:/gitrepos/libraries/mylibrary.git
  42. # c:/gitrepos/libraries/myotherlibrary.git
  43. #
  44. # SINCE 0.5.0
  45. git.searchRepositoriesSubfolders = true
  46. # Maximum number of folders to recurse into when searching for repositories.
  47. # The default value, -1, disables depth limits.
  48. #
  49. # SINCE 1.1.0
  50. git.searchRecursionDepth = -1
  51. # List of regex exclusion patterns to match against folders found in
  52. # *git.repositoriesFolder*.
  53. # Use forward slashes even on Windows!!
  54. # e.g. test/jgit\.git
  55. #
  56. # SPACE-DELIMITED
  57. # CASE-SENSITIVE
  58. # SINCE 1.1.0
  59. git.searchExclusions =
  60. # List of regex url patterns for extracting a repository name when locating
  61. # submodules.
  62. # e.g. git.submoduleUrlPatterns = .*?://github.com/(.*) will extract
  63. # *gitblit/gitblit.git* from *git://github.com/gitblit/gitblit.git*
  64. # If no matches are found then the submodule repository name is assumed to be
  65. # whatever trails the last / character. (e.g. gitblit.git).
  66. #
  67. # SPACE-DELIMITED
  68. # CASE-SENSITIVE
  69. # SINCE 1.1.0
  70. git.submoduleUrlPatterns = .*?://github.com/(.*)
  71. # Specify the interface for Git Daemon to bind it's service.
  72. # You may specify an ip or an empty value to bind to all interfaces.
  73. # Specifying localhost will result in Gitblit ONLY listening to requests to
  74. # localhost.
  75. #
  76. # SINCE 1.3.0
  77. # RESTART REQUIRED
  78. git.daemonBindInterface = localhost
  79. # port for serving the Git Daemon service. <= 0 disables this service.
  80. # On Unix/Linux systems, ports < 1024 require root permissions.
  81. # Recommended value: 9418
  82. #
  83. # SINCE 1.3.0
  84. # RESTART REQUIRED
  85. git.daemonPort = 9418
  86. # Allow push/pull over http/https with JGit servlet.
  87. # If you do NOT want to allow Git clients to clone/push to Gitblit set this
  88. # to false. You might want to do this if you are only using ssh:// or git://.
  89. # If you set this false, consider changing the *web.otherUrls* setting to
  90. # indicate your clone/push urls.
  91. #
  92. # SINCE 0.5.0
  93. git.enableGitServlet = true
  94. # If you want to restrict all git servlet access to those with valid X509 client
  95. # certificates then set this value to true.
  96. #
  97. # SINCE 1.2.0
  98. git.requiresClientCertificate = false
  99. # Enforce date checks on client certificates to ensure that they are not being
  100. # used prematurely and that they have not expired.
  101. #
  102. # SINCE 1.2.0
  103. git.enforceCertificateValidity = true
  104. # List of OIDs to extract from a client certificate DN to map a certificate to
  105. # an account username.
  106. #
  107. # e.g. git.certificateUsernameOIDs = CN
  108. # e.g. git.certificateUsernameOIDs = FirstName LastName
  109. #
  110. # SPACE-DELIMITED
  111. # SINCE 1.2.0
  112. git.certificateUsernameOIDs = CN
  113. # Only serve/display bare repositories.
  114. # If there are non-bare repositories in git.repositoriesFolder and this setting
  115. # is true, they will be excluded from the ui.
  116. #
  117. # SINCE 0.9.0
  118. git.onlyAccessBareRepositories = false
  119. # Allow an authenticated user to create a destination repository on a push if
  120. # the repository does not already exist.
  121. #
  122. # Administrator accounts can create a repository in any project.
  123. # These repositories are created with the default access restriction and authorization
  124. # control values. The pushing account is set as the owner.
  125. #
  126. # Non-administrator accounts with the CREATE role may create personal repositories.
  127. # These repositories are created as VIEW restricted for NAMED users.
  128. # The pushing account is set as the owner.
  129. #
  130. # SINCE 1.2.0
  131. git.allowCreateOnPush = true
  132. # Global setting to control anonymous pushes.
  133. #
  134. # This setting allows/rejects anonymous pushes at the level of the receive pack.
  135. # This trumps all repository config settings. While anonymous pushes are convenient
  136. # on your own box when you are a lone developer, they are not recommended for
  137. # any multi-user installation where accountability is required. Since Gitblit
  138. # tracks pushes and user accounts, allowing anonymous pushes compromises that
  139. # information.
  140. #
  141. # SINCE 1.4.0
  142. git.allowAnonymousPushes = false
  143. # The default access restriction for new repositories.
  144. # Valid values are NONE, PUSH, CLONE, VIEW
  145. # NONE = anonymous view, clone, & push
  146. # PUSH = anonymous view & clone and authenticated push
  147. # CLONE = anonymous view, authenticated clone & push
  148. # VIEW = authenticated view, clone, & push
  149. #
  150. # SINCE 1.0.0
  151. git.defaultAccessRestriction = PUSH
  152. # The default authorization control for new repositories.
  153. # Valid values are AUTHENTICATED and NAMED
  154. # AUTHENTICATED = any authenticated user is granted restricted access
  155. # NAMED = only named users/teams are granted restricted access
  156. #
  157. # SINCE 1.1.0
  158. git.defaultAuthorizationControl = NAMED
  159. # The prefix for a users personal repository directory.
  160. #
  161. # Personal user repositories are created in this directory, named by the user name
  162. # prefixed with the userRepositoryPrefix. For eaxmple, a user 'john' would have his
  163. # personal repositories in the directory '~john'.
  164. #
  165. # Cannot be an empty string. Also, absolute paths are changed to relative paths by
  166. # removing the first directory separator.
  167. #
  168. # It is not recommended to change this value AFTER your user's have created
  169. # personal repositories because it will break all permissions, ownership, and
  170. # repository push/pull operations.
  171. #
  172. # RESTART REQUIRED
  173. # SINCE 1.4.0
  174. git.userRepositoryPrefix = ~
  175. # The default incremental push tag prefix. Tag prefix applied to a repository
  176. # that has automatic push tags enabled and does not specify a custom tag prefix.
  177. #
  178. # If incremental push tags are enabled, the tips of each branch in the push will
  179. # be tagged with an increasing revision integer.
  180. #
  181. # e.g. refs/tags/r2345 or refs/tags/rev_2345
  182. #
  183. # SINCE 1.3.0
  184. git.defaultIncrementalPushTagPrefix = r
  185. # Controls creating a repository as --shared on Unix servers.
  186. #
  187. # In an Unix environment where mixed access methods exist for shared repositories,
  188. # the repository should be created with 'git init --shared' to make sure that
  189. # it can be accessed e.g. via ssh (user git) and http (user www-data).
  190. #
  191. # Valid values are the values available for the '--shared' option. The the manual
  192. # page for 'git init' for more information on shared repositories.
  193. #
  194. # SINCE 1.4.0
  195. git.createRepositoriesShared = false
  196. # Enable JGit-based garbage collection. (!!EXPERIMENTAL!!)
  197. #
  198. # USE AT YOUR OWN RISK!
  199. #
  200. # If enabled, the garbage collection executor scans all repositories once a day
  201. # at the hour of your choosing. The GC executor will take each repository "offline",
  202. # one-at-a-time, to check if the repository satisfies it's GC trigger requirements.
  203. #
  204. # While the repository is offline it will be inaccessible from the web UI or from
  205. # any of the other services (git, rpc, rss, etc).
  206. #
  207. # Gitblit's GC Executor MAY NOT PLAY NICE with the other Git kids on the block,
  208. # especially on Windows systems, so if you are using other tools please coordinate
  209. # their usage with your GC Executor schedule or do not use this feature.
  210. #
  211. # The GC algorithm complex and the JGit team advises caution when using their
  212. # young implementation of GC.
  213. #
  214. # http://wiki.eclipse.org/EGit/New_and_Noteworthy/2.1#Garbage_Collector_and_Repository_Storage_Statistics
  215. #
  216. # EXPERIMENTAL
  217. # SINCE 1.2.0
  218. # RESTART REQUIRED
  219. git.enableGarbageCollection = false
  220. # Hour of the day for the GC Executor to scan repositories.
  221. # This value is in 24-hour time.
  222. #
  223. # SINCE 1.2.0
  224. git.garbageCollectionHour = 0
  225. # The default minimum total filesize of loose objects to trigger early garbage
  226. # collection.
  227. #
  228. # You may specify a custom threshold for a repository in the repository's settings.
  229. # Common unit suffixes of k, m, or g are supported.
  230. #
  231. # SINCE 1.2.0
  232. git.defaultGarbageCollectionThreshold = 500k
  233. # The default period, in days, between GCs for a repository. If the total filesize
  234. # of the loose object exceeds *git.garbageCollectionThreshold* or the repository's
  235. # custom threshold, this period will be short-circuited.
  236. #
  237. # e.g. if a repository collects 100KB of loose objects every day with a 500KB
  238. # threshold and a period of 7 days, it will take 5 days for the loose objects to
  239. # be collected, packed, and pruned.
  240. #
  241. # OR
  242. #
  243. # if a repository collects 10KB of loose objects every day with a 500KB threshold
  244. # and a period of 7 days, it will take the full 7 days for the loose objects to be
  245. # collected, packed, and pruned.
  246. #
  247. # You may specify a custom period for a repository in the repository's settings.
  248. #
  249. # The minimum value is 1 day since the GC Executor only runs once a day.
  250. #
  251. # SINCE 1.2.0
  252. git.defaultGarbageCollectionPeriod = 7
  253. # Gitblit can automatically fetch ref updates for a properly configured mirror
  254. # repository.
  255. #
  256. # Requirements:
  257. # 1. you must manually clone the repository using native git
  258. # git clone --mirror git://somewhere.com/myrepo.git
  259. # 2. the "origin" remote must be the mirror source
  260. # 3. the "origin" repository must be accessible without authentication OR the
  261. # credentials must be embedded in the origin url (not recommended)
  262. #
  263. # Notes:
  264. # 1. "origin" SSH urls are untested and not likely to work
  265. # 2. mirrors cloned while Gitblit is running are likely to require clearing the
  266. # gitblit cache (link on the repositories page of an administrator account)
  267. # 3. Gitblit will automatically repair any invalid fetch refspecs with a "//"
  268. # sequence.
  269. #
  270. # SINCE 1.4.0
  271. # RESTART REQUIRED
  272. git.enableMirroring = false
  273. # Specify the period between update checks for mirrored repositories.
  274. # The shortest period you may specify between mirror update checks is 5 mins.
  275. #
  276. # SINCE 1.4.0
  277. # RESTART REQUIRED
  278. git.mirrorPeriod = 30 mins
  279. # Number of bytes of a pack file to load into memory in a single read operation.
  280. # This is the "page size" of the JGit buffer cache, used for all pack access
  281. # operations. All disk IO occurs as single window reads. Setting this too large
  282. # may cause the process to load more data than is required; setting this too small
  283. # may increase the frequency of read() system calls.
  284. #
  285. # Default on JGit is 8 KiB on all platforms.
  286. #
  287. # Common unit suffixes of k, m, or g are supported.
  288. # Documentation courtesy of the Gerrit project.
  289. #
  290. # SINCE 1.0.0
  291. # RESTART REQUIRED
  292. git.packedGitWindowSize = 8k
  293. # Maximum number of bytes to load and cache in memory from pack files. If JGit
  294. # needs to access more than this many bytes it will unload less frequently used
  295. # windows to reclaim memory space within the process. As this buffer must be shared
  296. # with the rest of the JVM heap, it should be a fraction of the total memory available.
  297. #
  298. # The JGit team recommends setting this value larger than the size of your biggest
  299. # repository. This ensures you can serve most requests from memory.
  300. #
  301. # Default on JGit is 10 MiB on all platforms.
  302. #
  303. # Common unit suffixes of k, m, or g are supported.
  304. # Documentation courtesy of the Gerrit project.
  305. #
  306. # SINCE 1.0.0
  307. # RESTART REQUIRED
  308. git.packedGitLimit = 10m
  309. # Maximum number of bytes to reserve for caching base objects that multiple deltafied
  310. # objects reference. By storing the entire decompressed base object in a cache Git
  311. # is able to avoid unpacking and decompressing frequently used base objects multiple times.
  312. #
  313. # Default on JGit is 10 MiB on all platforms. You probably do not need to adjust
  314. # this value.
  315. #
  316. # Common unit suffixes of k, m, or g are supported.
  317. # Documentation courtesy of the Gerrit project.
  318. #
  319. # SINCE 1.0.0
  320. # RESTART REQUIRED
  321. git.deltaBaseCacheLimit = 10m
  322. # Maximum number of pack files to have open at once. A pack file must be opened
  323. # in order for any of its data to be available in a cached window.
  324. #
  325. # If you increase this to a larger setting you may need to also adjust the ulimit
  326. # on file descriptors for the host JVM, as Gitblit needs additional file descriptors
  327. # available for network sockets and other repository data manipulation.
  328. #
  329. # Default on JGit is 128 file descriptors on all platforms.
  330. # Documentation courtesy of the Gerrit project.
  331. #
  332. # SINCE 1.0.0
  333. # RESTART REQUIRED
  334. git.packedGitOpenFiles = 128
  335. # Largest object size, in bytes, that JGit will allocate as a contiguous byte
  336. # array. Any file revision larger than this threshold will have to be streamed,
  337. # typically requiring the use of temporary files under $GIT_DIR/objects to implement
  338. # psuedo-random access during delta decompression.
  339. #
  340. # Servers with very high traffic should set this to be larger than the size of
  341. # their common big files. For example a server managing the Android platform
  342. # typically has to deal with ~10-12 MiB XML files, so 15 m would be a reasonable
  343. # setting in that environment. Setting this too high may cause the JVM to run out
  344. # of heap space when handling very big binary files, such as device firmware or
  345. # CD-ROM ISO images. Make sure to adjust your JVM heap accordingly.
  346. #
  347. # Default is 50 MiB on all platforms.
  348. #
  349. # Common unit suffixes of k, m, or g are supported.
  350. # Documentation courtesy of the Gerrit project.
  351. #
  352. #
  353. # NOTE: The importance of JGit's streamFileTreshold AND Git's bigFileThreshold
  354. # ISSUE: https://bugs.eclipse.org/bugs/show_bug.cgi?id=394078
  355. #
  356. # "core.bigFileThreshold
  357. #
  358. # Files larger than this size are stored deflated, without
  359. # attempting delta compression. Storing large files without
  360. # delta compression avoids excessive memory usage, at the
  361. # slight expense of increased disk usage.
  362. #
  363. # Default is 512 MiB on all platforms.
  364. # This should be reasonable for most projects as source code and other
  365. # text files can still be delta compressed,
  366. # but larger binary media files won't be."
  367. # -- Git documentation
  368. #
  369. # If streamFileTreshold < bigFileTreshold you _may_ spend alot of time waiting
  370. # for push and/or fetch to complete. It may even look hung.
  371. #
  372. # Until the issue is resolved gracefully, a workaround is to configure
  373. # bigFileThreshold < streamFileTreshold AND then repack the repository.
  374. #
  375. # e.g. from the repository folder with Gitblit NOT running:
  376. # git config core.bigFileTreshold 40m
  377. # git gc --aggressive
  378. #
  379. # SINCE 1.0.0
  380. # RESTART REQUIRED
  381. git.streamFileThreshold = 50m
  382. # When true, JGit will use mmap() rather than malloc()+read() to load data from
  383. # pack files. The use of mmap can be problematic on some JVMs as the garbage
  384. # collector must deduce that a memory mapped segment is no longer in use before
  385. # a call to munmap() can be made by the JVM native code.
  386. #
  387. # In server applications (such as Gitblit) that need to access many pack files,
  388. # setting this to true risks artificially running out of virtual address space,
  389. # as the garbage collector cannot reclaim unused mapped spaces fast enough.
  390. #
  391. # Default on JGit is false. Although potentially slower, it yields much more
  392. # predictable behavior.
  393. # Documentation courtesy of the Gerrit project.
  394. #
  395. # SINCE 1.0.0
  396. # RESTART REQUIRED
  397. git.packedGitMmap = false
  398. #
  399. # Groovy Integration
  400. #
  401. # Location of Groovy scripts to use for Pre and Post receive hooks.
  402. # Use forward slashes even on Windows!!
  403. # e.g. c:/groovy
  404. #
  405. # RESTART REQUIRED
  406. # SINCE 0.8.0
  407. # BASEFOLDER
  408. groovy.scriptsFolder = ${baseFolder}/groovy
  409. # Specify the directory Grape uses for downloading libraries.
  410. # http://groovy.codehaus.org/Grape
  411. #
  412. # RESTART REQUIRED
  413. # SINCE 1.0.0
  414. # BASEFOLDER
  415. groovy.grapeFolder = ${baseFolder}/groovy/grape
  416. # Scripts to execute on Pre-Receive.
  417. #
  418. # These scripts execute after an incoming push has been parsed and validated
  419. # but BEFORE the changes are applied to the repository. You might reject a
  420. # push in this script based on the repository and branch the push is attempting
  421. # to change.
  422. #
  423. # Script names are case-sensitive on case-sensitive file systems. You may omit
  424. # the traditional ".groovy" from this list if your file extension is ".groovy"
  425. #
  426. # NOTE:
  427. # These scripts are only executed when pushing to *Gitblit*, not to other Git
  428. # tooling you may be using. Also note that these scripts are shared between
  429. # repositories. These are NOT repository-specific scripts! Within the script
  430. # you may customize the control-flow for a specific repository by checking the
  431. # *repository* variable.
  432. #
  433. # SPACE-DELIMITED
  434. # CASE-SENSITIVE
  435. # SINCE 0.8.0
  436. groovy.preReceiveScripts =
  437. # Scripts to execute on Post-Receive.
  438. #
  439. # These scripts execute AFTER an incoming push has been applied to a repository.
  440. # You might trigger a continuous-integration build here or send a notification.
  441. #
  442. # Script names are case-sensitive on case-sensitive file systems. You may omit
  443. # the traditional ".groovy" from this list if your file extension is ".groovy"
  444. #
  445. # NOTE:
  446. # These scripts are only executed when pushing to *Gitblit*, not to other Git
  447. # tooling you may be using. Also note that these scripts are shared between
  448. # repositories. These are NOT repository-specific scripts! Within the script
  449. # you may customize the control-flow for a specific repository by checking the
  450. # *repository* variable.
  451. #
  452. # SPACE-DELIMITED
  453. # CASE-SENSITIVE
  454. # SINCE 0.8.0
  455. groovy.postReceiveScripts =
  456. # Repository custom fields for Groovy Hook mechanism
  457. #
  458. # List of key=label pairs of custom fields to prompt for in the Edit Repository
  459. # page. These keys are stored in the repository's git config file in the
  460. # section [gitblit "customFields"]. Key names are alphanumeric only. These
  461. # fields are intended to be used for the Groovy hook mechanism where a script
  462. # can adjust it's execution based on the custom fields stored in the repository
  463. # config.
  464. #
  465. # e.g. "commitMsgRegex=Commit Message Regular Expression" anotherProperty=Another
  466. #
  467. # SPACE-DELIMITED
  468. # SINCE 1.0.0
  469. groovy.customFields =
  470. #
  471. # Fanout Settings
  472. #
  473. # Fanout is a PubSub notification service that can be used by Sparkleshare
  474. # to eliminate repository change polling. The fanout service runs in a separate
  475. # thread on a separate port from the Gitblit http/https application.
  476. # This service is provided so that Sparkleshare may be used with Gitblit in
  477. # firewalled environments or where reliance on Sparkleshare's default notifications
  478. # server (notifications.sparkleshare.org) is unwanted.
  479. #
  480. # This service maintains an open socket connection from the client to the
  481. # Fanout PubSub service. This service may not work properly behind a proxy server.
  482. # Specify the interface for Fanout to bind it's service.
  483. # You may specify an ip or an empty value to bind to all interfaces.
  484. # Specifying localhost will result in Gitblit ONLY listening to requests to
  485. # localhost.
  486. #
  487. # SINCE 1.2.1
  488. # RESTART REQUIRED
  489. fanout.bindInterface = localhost
  490. # port for serving the Fanout PubSub service. <= 0 disables this service.
  491. # On Unix/Linux systems, ports < 1024 require root permissions.
  492. # Recommended value: 17000
  493. #
  494. # SINCE 1.2.1
  495. # RESTART REQUIRED
  496. fanout.port = 0
  497. # Use Fanout NIO service. If false, a multi-threaded socket service will be used.
  498. # Be advised, the socket implementation spawns a thread per connection plus the
  499. # connection acceptor thread. The NIO implementation is completely single-threaded.
  500. #
  501. # SINCE 1.2.1
  502. # RESTART REQUIRED
  503. fanout.useNio = true
  504. # Concurrent connection limit. <= 0 disables concurrent connection throttling.
  505. # If > 0, only the specified number of concurrent connections will be allowed
  506. # and all other connections will be rejected.
  507. #
  508. # SINCE 1.2.1
  509. # RESTART REQUIRED
  510. fanout.connectionLimit = 0
  511. #
  512. # Authentication Settings
  513. #
  514. # Require authentication to see everything but the admin pages
  515. #
  516. # SINCE 0.5.0
  517. # RESTART REQUIRED
  518. web.authenticateViewPages = false
  519. # If web.authenticateViewPages=true you may optionally require a client-side
  520. # basic authentication prompt instead of the standard form-based login.
  521. #
  522. # SINCE 1.3.0
  523. web.enforceHttpBasicAuthentication = false
  524. # Require admin authentication for the admin functions and pages
  525. #
  526. # SINCE 0.5.0
  527. # RESTART REQUIRED
  528. web.authenticateAdminPages = true
  529. # Allow Gitblit to store a cookie in the user's browser for automatic
  530. # authentication. The cookie is generated by the user service.
  531. #
  532. # SINCE 0.5.0
  533. web.allowCookieAuthentication = true
  534. # Config file for storing project metadata
  535. #
  536. # SINCE 1.2.0
  537. # BASEFOLDER
  538. web.projectsFile = ${baseFolder}/projects.conf
  539. # Either the full path to a user config file (users.conf)
  540. # OR a fully qualified class name that implements the IUserService interface.
  541. #
  542. # Any custom user service implementation must have a public default constructor.
  543. #
  544. # SINCE 0.5.0
  545. # RESTART REQUIRED
  546. # BASEFOLDER
  547. realm.userService = ${baseFolder}/users.conf
  548. # Ordered list of external authentication providers which will be used if
  549. # authentication against the local user service fails.
  550. #
  551. # Valid providers are:
  552. #
  553. # htpasswd
  554. # ldap
  555. # pam
  556. # redmine
  557. # salesforce
  558. # windows
  559. # e.g. realm.authenticationProviders = htpasswd windows
  560. #
  561. # SINCE 1.4.0
  562. # RESTART REQUIRED
  563. # SPACE-DELIMITED
  564. realm.authenticationProviders =
  565. # How to store passwords.
  566. # Valid values are plain, md5, or combined-md5. md5 is the hash of password.
  567. # combined-md5 is the hash of username.toLowerCase()+password.
  568. # Default is md5.
  569. #
  570. # SINCE 0.5.0
  571. realm.passwordStorage = md5
  572. # Minimum valid length for a plain text password.
  573. # Default value is 5. Absolute minimum is 4.
  574. #
  575. # SINCE 0.5.0
  576. realm.minPasswordLength = 5
  577. #
  578. # Gitblit Web Settings
  579. #
  580. # If blank Gitblit is displayed.
  581. #
  582. # SINCE 0.5.0
  583. web.siteName =
  584. # The canonical url of your Gitblit server to bs used in email notifications.
  585. # e.g. web.canonicalUrl = https://demo-gitblit.rhcloud.com
  586. #
  587. # SINCE 1.4.0
  588. web.canonicalUrl =
  589. # You may specify a different logo image for the header but it must be 120x45px.
  590. # If the specified file does not exist, the default Gitblit logo will be used.
  591. #
  592. # SINCE 1.3.0
  593. # BASEFOLDER
  594. web.headerLogo = ${baseFolder}/logo.png
  595. # You may specify a different link URL for the logo image anchor.
  596. # If blank the Gitblit main page URL is used.
  597. #
  598. # SINCE 1.3.0
  599. # BASEFOLDER
  600. web.rootLink =
  601. # You may specify a custom header background CSS color. If unspecified, the
  602. # default color will be used.
  603. #
  604. # e.g. web.headerBackgroundColor = #002060
  605. #
  606. # SINCE 1.3.0
  607. web.headerBackgroundColor =
  608. # You may specify a custom header foreground CSS color. If unspecified, the
  609. # default color will be used.
  610. #
  611. # e.g. web.headerForegroundColor = white
  612. #
  613. # SINCE 1.3.0
  614. web.headerForegroundColor =
  615. # You may specify a custom header foreground hover CSS color. If unspecified, the
  616. # default color will be used.
  617. #
  618. # e.g. web.headerHoverColor = white
  619. #
  620. # SINCE 1.3.0
  621. web.headerHoverColor =
  622. # You may specify a custom header border CSS color. If unspecified, the default
  623. # color will be used.
  624. #
  625. # e.g. web.headerBorderColor = #002060
  626. #
  627. # SINCE 1.3.0
  628. web.headerBorderColor =
  629. # You may specify a custom header border CSS color. If unspecified, the default
  630. # color will be used.
  631. #
  632. # e.g. web.headerBorderFocusColor = #ff9900
  633. #
  634. # SINCE 1.3.0
  635. web.headerBorderFocusColor =
  636. # If *web.authenticateAdminPages*=true, users with "admin" role can create
  637. # repositories, create users, and edit repository metadata.
  638. #
  639. # If *web.authenticateAdminPages*=false, any user can execute the aforementioned
  640. # functions.
  641. #
  642. # SINCE 0.5.0
  643. web.allowAdministration = true
  644. # Allows rpc clients to list repositories and possibly manage or administer the
  645. # Gitblit server, if the authenticated account has administrator permissions.
  646. # See *web.enableRpcManagement* and *web.enableRpcAdministration*.
  647. #
  648. # SINCE 0.7.0
  649. web.enableRpcServlet = true
  650. # Allows rpc clients to manage repositories and users of the Gitblit instance,
  651. # if the authenticated account has administrator permissions.
  652. # Requires *web.enableRpcServlet=true*.
  653. #
  654. # SINCE 0.7.0
  655. web.enableRpcManagement = false
  656. # Allows rpc clients to control the server settings and monitor the health of this
  657. # this Gitblit instance, if the authenticated account has administrator permissions.
  658. # Requires *web.enableRpcServlet=true* and *web.enableRpcManagement*.
  659. #
  660. # SINCE 0.7.0
  661. web.enableRpcAdministration = false
  662. # Full path to a configurable robots.txt file. With this file you can control
  663. # what parts of your Gitblit server respectable robots are allowed to traverse.
  664. # http://googlewebmastercentral.blogspot.com/2008/06/improving-on-robots-exclusion-protocol.html
  665. #
  666. # SINCE 1.0.0
  667. # BASEFOLDER
  668. web.robots.txt = ${baseFolder}/robots.txt
  669. # The number of minutes to cache a page in the browser since the last request.
  670. # The default value is 0 minutes. A value <= 0 disables all page caching which
  671. # is the default behavior for Gitblit <= 1.3.0.
  672. #
  673. # SINCE 1.3.1
  674. web.pageCacheExpires = 0
  675. # If true, the web ui layout will respond and adapt to the browser's dimensions.
  676. # if false, the web ui will use a 940px fixed-width layout.
  677. # http://twitter.github.com/bootstrap/scaffolding.html#responsive
  678. #
  679. # SINCE 1.0.0
  680. web.useResponsiveLayout = true
  681. # Allow Gravatar images to be displayed in Gitblit pages.
  682. #
  683. # SINCE 0.8.0
  684. web.allowGravatar = true
  685. # Allow dynamic zip downloads.
  686. #
  687. # SINCE 0.5.0
  688. web.allowZipDownloads = true
  689. # If *web.allowZipDownloads=true* the following formats will be displayed for
  690. # download compressed archive links:
  691. #
  692. # zip = standard .zip
  693. # tar = standard tar format (preserves *nix permissions and symlinks)
  694. # gz = gz-compressed tar
  695. # xz = xz-compressed tar
  696. # bzip2 = bzip2-compressed tar
  697. #
  698. # SPACE-DELIMITED
  699. # SINCE 1.2.0
  700. web.compressedDownloads = zip gz
  701. # Allow optional Lucene integration. Lucene indexing is an opt-in feature.
  702. # A repository may specify branches to index with Lucene instead of using Git
  703. # commit traversal. There are scenarios where you may want to completely disable
  704. # Lucene indexing despite a repository specifying indexed branches. One such
  705. # scenario is on a resource-constrained federated Gitblit mirror.
  706. #
  707. # SINCE 0.9.0
  708. web.allowLuceneIndexing = true
  709. # Allows an authenticated user to create forks of a repository
  710. #
  711. # set this to false if you want to disable all fork controls on the web site
  712. #
  713. web.allowForking = true
  714. # Controls the length of shortened commit hash ids
  715. #
  716. # SINCE 1.2.0
  717. web.shortCommitIdLength = 6
  718. # Use Clippy (Flash solution) to provide a copy-to-clipboard button.
  719. # If false, a button with a more primitive JavaScript-based prompt box will
  720. # offer a 3-step (click, ctrl+c, enter) copy-to-clipboard alternative.
  721. #
  722. # SINCE 0.8.0
  723. web.allowFlashCopyToClipboard = true
  724. # Default maximum number of commits that a repository may contribute to the
  725. # activity page, regardless of the selected duration. This setting may be valuable
  726. # for an extremely busy server. This value may also be configed per-repository
  727. # in Edit Repository. 0 disables this throttle.
  728. #
  729. # SINCE 1.2.0
  730. web.maxActivityCommits = 0
  731. # Default number of entries to include in RSS Syndication links
  732. #
  733. # SINCE 0.5.0
  734. web.syndicationEntries = 25
  735. # Show the size of each repository on the repositories page.
  736. # This requires recursive traversal of each repository folder. This may be
  737. # non-performant on some operating systems and/or filesystems.
  738. #
  739. # SINCE 0.5.2
  740. web.showRepositorySizes = true
  741. # List of custom regex expressions that can be displayed in the Filters menu
  742. # of the Repositories and Activity pages. Keep them very simple because you
  743. # are likely to run into encoding issues if they are too complex.
  744. #
  745. # Use !!! to separate the filters
  746. #
  747. # SINCE 0.8.0
  748. web.customFilters =
  749. # Show federation registrations (without token) and the current pull status
  750. # to non-administrator users.
  751. #
  752. # SINCE 0.6.0
  753. web.showFederationRegistrations = false
  754. # This is the message displayed when *web.authenticateViewPages=true*.
  755. # This can point to a file with Markdown content.
  756. # Specifying "gitblit" uses the internal login message.
  757. #
  758. # SINCE 0.7.0
  759. # BASEFOLDER
  760. web.loginMessage = gitblit
  761. # This is the message displayed above the repositories table.
  762. # This can point to a file with Markdown content.
  763. # Specifying "gitblit" uses the internal welcome message.
  764. #
  765. # SINCE 0.5.0
  766. # BASEFOLDER
  767. web.repositoriesMessage = gitblit
  768. # Ordered list of charsets/encodings to use when trying to display a blob.
  769. # If empty, UTF-8 and ISO-8859-1 are used. The server's default charset
  770. # is always appended to the encoding list. If all encodings fail to cleanly
  771. # decode the blob content, UTF-8 will be used with the standard malformed
  772. # input/unmappable character replacement strings.
  773. #
  774. # SPACE-DELIMITED
  775. # SINCE 1.0.0
  776. web.blobEncodings = UTF-8 ISO-8859-1
  777. # Manually set the default timezone to be used by Gitblit for display in the
  778. # web ui. This value is independent of the JVM timezone. Specifying a blank
  779. # value will default to the JVM timezone.
  780. # e.g. America/New_York, US/Pacific, UTC, Europe/Berlin
  781. #
  782. # SINCE 0.9.0
  783. # RESTART REQUIRED
  784. web.timezone =
  785. # Use the client timezone when formatting dates.
  786. # This uses AJAX to determine the browser's timezone and may require more
  787. # server overhead because a Wicket session is created. All Gitblit pages
  788. # attempt to be stateless, if possible.
  789. #
  790. # SINCE 0.5.0
  791. # RESTART REQUIRED
  792. web.useClientTimezone = false
  793. # Time format
  794. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  795. #
  796. # SINCE 0.8.0
  797. web.timeFormat = HH:mm
  798. # Short date format
  799. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  800. #
  801. # SINCE 0.5.0
  802. web.datestampShortFormat = yyyy-MM-dd
  803. # Long date format
  804. #
  805. # SINCE 0.8.0
  806. web.datestampLongFormat = EEEE, MMMM d, yyyy
  807. # Long timestamp format
  808. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  809. #
  810. # SINCE 0.5.0
  811. web.datetimestampLongFormat = EEEE, MMMM d, yyyy HH:mm Z
  812. # Mount URL parameters
  813. # This setting controls if pretty or parameter URLs are used.
  814. # i.e.
  815. # if true:
  816. # http://localhost/commit/myrepo/abcdef
  817. # if false:
  818. # http://localhost/commit/?r=myrepo&h=abcdef
  819. #
  820. # SINCE 0.5.0
  821. # RESTART REQUIRED
  822. web.mountParameters = true
  823. # Some servlet containers (e.g. Tomcat >= 6.0.10) disallow '/' (%2F) encoding
  824. # in URLs as a security precaution for proxies. This setting tells Gitblit
  825. # to preemptively replace '/' with '*' or '!' for url string parameters.
  826. #
  827. # <https://issues.apache.org/jira/browse/WICKET-1303>
  828. # <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>
  829. # Add *-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to your
  830. # *CATALINA_OPTS* or to your JVM launch parameters
  831. #
  832. # SINCE 0.5.2
  833. web.forwardSlashCharacter = /
  834. # Show other URLs on the summary page for accessing your git repositories
  835. # Use spaces to separate urls.
  836. #
  837. # {0} is the token for the repository name
  838. # {1} is the token for the username
  839. #
  840. # The username is only practical if you have setup your other git serving
  841. # solutions accounts to have the same username as the Gitblit account.
  842. #
  843. # e.g.
  844. # web.otherUrls = ssh://localhost/git/{0} git://localhost/git/{0} https://{1}@localhost/r/{0}
  845. #
  846. # SPACE-DELIMITED
  847. # SINCE 0.5.0
  848. web.otherUrls =
  849. # Should app-specific clone links be displayed for SourceTree, SparkleShare, etc?
  850. #
  851. # SINCE 1.3.0
  852. web.allowAppCloneLinks = true
  853. # Choose how to present the repositories list.
  854. # grouped = group nested/subfolder repositories together (no sorting)
  855. # flat = flat list of repositories (sorting allowed)
  856. #
  857. # SINCE 0.5.0
  858. web.repositoryListType = grouped
  859. # If using a grouped repository list and there are repositories at the
  860. # root level of your repositories folder, you may specify the displayed
  861. # group name with this setting. This value is only used for web presentation.
  862. #
  863. # SINCE 0.5.0
  864. web.repositoryRootGroupName = main
  865. # Display the repository swatch color next to the repository name link in the
  866. # repositories list.
  867. #
  868. # SINCE 0.8.0
  869. web.repositoryListSwatches = true
  870. # Defines the default commit message renderer. This can be configured
  871. # per-repository.
  872. #
  873. # Valid values are: plain, markdown
  874. #
  875. # SINCE 1.4.0
  876. web.commitMessageRenderer = plain
  877. # Control if email addresses are shown in web ui
  878. #
  879. # SINCE 0.5.0
  880. web.showEmailAddresses = true
  881. # Shows a combobox in the page links header with commit, committer, and author
  882. # search selection. Default search is commit.
  883. #
  884. # SINCE 0.5.0
  885. web.showSearchTypeSelection = false
  886. # Controls display of activity graphs on the dashboard, activity, and summary
  887. # pages. Charting makes use of the external Google Charts API.
  888. #
  889. # SINCE 0.5.0
  890. web.generateActivityGraph = true
  891. # Displays the commits branch graph in the summary page and commits/log page.
  892. #
  893. # SINCE 1.4.0
  894. web.showBranchGraph = true
  895. # The default number of days to show on the activity page.
  896. # Value must exceed 0 else default of 7 is used
  897. #
  898. # SINCE 0.8.0
  899. web.activityDuration = 7
  900. # Choices for days of activity to display.
  901. #
  902. # SPACE-DELIMITED
  903. # SINCE 1.3.0
  904. web.activityDurationChoices = 1 3 7 14 21 28
  905. # Maximum number of days of activity that may be displayed on the activity page.
  906. #
  907. # SINCE 1.3.2
  908. web.activityDurationMaximum = 30
  909. # The number of days of commits to cache in memory for the dashboard, activity,
  910. # and project pages. A value of 0 will disable all caching and will parse commits
  911. # in each repository per-request. If the value > 0 these pages will try to fulfill
  912. # requests using the commit cache. If the request specifies a period which falls
  913. # outside the commit cache window, then the cache will be ignored and the request
  914. # will be fulfilled by brute-force parsing all relevant commits per-repository.
  915. #
  916. # Consider the values specified for *web.activityDurationChoices* when setting
  917. # the cache size AND consider adjusting the JVM -Xmx heap parameter appropriately.
  918. #
  919. # SINCE 1.3.0
  920. # RESTART REQUIRED
  921. web.activityCacheDays = 14
  922. # Case-insensitive list of authors to exclude from metrics. Useful for
  923. # eliminating bots.
  924. #
  925. # SPACE-DELIMITED
  926. # SINCE 1.3.0
  927. web.metricAuthorExclusions =
  928. # The number of commits to display on the summary page
  929. # Value must exceed 0 else default of 20 is used
  930. #
  931. # SINCE 0.5.0
  932. web.summaryCommitCount = 16
  933. # The number of tags/branches to display on the summary page.
  934. # -1 = all tags/branches
  935. # 0 = hide tags/branches
  936. # N = N tags/branches
  937. #
  938. # SINCE 0.5.0
  939. web.summaryRefsCount = 5
  940. # Show a README file, if available, on the summary page.
  941. #
  942. # SINCE 1.4.0
  943. web.summaryShowReadme = false
  944. # The number of items to show on a page before showing the first, prev, next
  945. # pagination links. A default of 50 is used for any invalid value.
  946. #
  947. # SINCE 0.5.0
  948. web.itemsPerPage = 50
  949. # The number of reflog changes to display on the overview page
  950. # Value must exceed 0 else default of 5 is used
  951. #
  952. # SINCE 1.3.0
  953. web.overviewReflogCount = 5
  954. # The number of reflog changes to show on a reflog page before show the first,
  955. # prev, next pagination links. A default of 10 is used for any invalid value.
  956. #
  957. # SINCE 1.3.0
  958. web.reflogChangesPerPage = 10
  959. # Specify the names of documents in the root of your repository to be displayed
  960. # in tabs on your repository docs page. If the name is not found in the root
  961. # then no tab is added. The order specified is the order displayed. Do not
  962. # specify a file extension as the aggregation of markup extensions + txt are used
  963. # in the search algorithm.
  964. #
  965. # SPACE-DELIMITED
  966. # SINCE 1.4.0
  967. web.documents = readme home index changelog contributing submitting_patches copying license notice authors
  968. # Registered file extensions to ignore during Lucene indexing
  969. #
  970. # SPACE-DELIMITED
  971. # SINCE 0.9.0
  972. web.luceneIgnoreExtensions = 7z arc arj bin bmp dll doc docx exe gif gz jar jpg lib lzh odg odf odt pdf ppt pptx png so swf tar xcf xls xlsx zip
  973. # Registered extensions for google-code-prettify
  974. #
  975. # SPACE-DELIMITED
  976. # SINCE 0.5.0
  977. web.prettyPrintExtensions = aea agc basic c cbm cl clj cpp cs css dart el erl erlang frm fs go groovy hs htm html java js latex lisp ll llvm lsp lua ml moxie mumps n nemerle pascal php pl prefs properties proto py r R rb rd Rd rkt s S scala scm sh Splus sql ss tcl tex vb vbs vhd vhdl wiki xml xq xquery yaml yml ymlapollo
  978. # Registered extensions for markdown transformation
  979. #
  980. # SPACE-DELIMITED
  981. # CASE-SENSITIVE
  982. # SINCE 0.5.0
  983. web.markdownExtensions = md mkd markdown MD MKD
  984. # Registered extensions for mediawiki transformation
  985. #
  986. # SPACE-DELIMITED
  987. # CASE-SENSITIVE
  988. # SINCE 1.4.0
  989. web.mediawikiExtensions = mw mediawiki
  990. # Registered extensions for twiki transformation
  991. #
  992. # SPACE-DELIMITED
  993. # CASE-SENSITIVE
  994. # SINCE 1.4.0
  995. web.twikiExtensions = twiki
  996. # Registered extensions for textile transformation
  997. #
  998. # SPACE-DELIMITED
  999. # CASE-SENSITIVE
  1000. # SINCE 1.4.0
  1001. web.textileExtensions = textile
  1002. # Registered extensions for confluence transformation
  1003. #
  1004. # SPACE-DELIMITED
  1005. # CASE-SENSITIVE
  1006. # SINCE 1.4.0
  1007. web.confluenceExtensions = confluence
  1008. # Registered extensions for tracwiki transformation
  1009. #
  1010. # SPACE-DELIMITED
  1011. # CASE-SENSITIVE
  1012. # SINCE 1.4.0
  1013. web.tracwikiExtensions = tracwiki
  1014. # Image extensions
  1015. #
  1016. # SPACE-DELIMITED
  1017. # SINCE 0.5.0
  1018. web.imageExtensions = bmp jpg gif png
  1019. # Registered extensions for binary blobs
  1020. #
  1021. # SPACE-DELIMITED
  1022. # SINCE 0.5.0
  1023. web.binaryExtensions = 7z arc arj bin dll doc docx exe gz jar lib lzh odg odf odt pdf ppt pptx so tar xls xlsx zip
  1024. # Aggressive heap management will run the garbage collector on every generated
  1025. # page. This slows down page generation a little but improves heap consumption.
  1026. #
  1027. # SINCE 0.5.0
  1028. web.aggressiveHeapManagement = false
  1029. # Run the webapp in debug mode
  1030. #
  1031. # SINCE 0.5.0
  1032. # RESTART REQUIRED
  1033. web.debugMode = false
  1034. # Force a default locale for all users, ignoring the browser's settings.
  1035. # An empty value allows Gitblit to use the translation preferred by the browser.
  1036. #
  1037. # Changing this value while the server is running will only affect new sessions.
  1038. #
  1039. # e.g. web.forceDefaultLocale = en
  1040. #
  1041. # SINCE 1.3.0
  1042. web.forceDefaultLocale =
  1043. # Enable/disable global regex substitutions (i.e. shared across repositories)
  1044. #
  1045. # SINCE 0.5.0
  1046. # DEPRECATED 1.4.0 (migrate to bugtraq instead)
  1047. regex.global = true
  1048. # Example global regex substitutions
  1049. # Use !!! to separate the search pattern and the replace pattern
  1050. # searchpattern!!!replacepattern
  1051. # SINCE 0.5.0
  1052. # regex.global.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://somehost/bug/$3">$3</a>
  1053. # SINCE 0.5.0
  1054. # Example Gerrit links
  1055. # regex.global.changeid = \\b(Change-Id:\\s*)([A-Za-z0-9]*)\\b!!!Change-Id: <a href="http://somehost/r/#q,$2,n,z">$2</a>
  1056. # regex.global.reviewedon = \\b(Reviewed-on:\\s*)([A-Za-z0-9:/\\.]*)\\b!!!Reviewed-on: <a href="$2">$2</a>
  1057. # Example per-repository regex substitutions overrides global
  1058. # SINCE 0.5.0
  1059. # regex.myrepository.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://elsewhere/bug/$3">$3</a>
  1060. #
  1061. # Mail Settings
  1062. # SINCE 0.6.0
  1063. #
  1064. # Mail settings are used to notify administrators of received federation proposals
  1065. #
  1066. # ip or hostname of smtp server
  1067. #
  1068. # SINCE 0.6.0
  1069. mail.server =
  1070. # port to use for smtp requests
  1071. #
  1072. # SINCE 0.6.0
  1073. mail.port = 25
  1074. # debug the mail executor
  1075. #
  1076. # SINCE 0.6.0
  1077. mail.debug = false
  1078. # use SMTPs flag
  1079. mail.smtps = false
  1080. # if your smtp server requires authentication, supply the credentials here
  1081. #
  1082. # SINCE 0.6.0
  1083. mail.username =
  1084. # SINCE 0.6.0
  1085. mail.password =
  1086. # from address for generated emails
  1087. #
  1088. # SINCE 0.6.0
  1089. mail.fromAddress =
  1090. # List of email addresses for the Gitblit administrators
  1091. #
  1092. # SPACE-DELIMITED
  1093. # SINCE 0.6.0
  1094. mail.adminAddresses =
  1095. # List of email addresses for sending push email notifications.
  1096. #
  1097. # This key currently requires use of the sendemail.groovy hook script.
  1098. # If you set sendemail.groovy in *groovy.postReceiveScripts* then email
  1099. # notifications for all repositories (regardless of access restrictions!)
  1100. # will be sent to these addresses.
  1101. #
  1102. # SPACE-DELIMITED
  1103. # SINCE 0.8.0
  1104. mail.mailingLists =
  1105. #
  1106. # Federation Settings
  1107. # SINCE 0.6.0
  1108. #
  1109. # A Gitblit federation is a way to backup one Gitblit instance to another.
  1110. #
  1111. # *git.enableGitServlet* must be true to use this feature.
  1112. # Your federation name is used for federation status acknowledgments. If it is
  1113. # unset, and you elect to send a status acknowledgment, your Gitblit instance
  1114. # will be identified by its hostname, if available, else your internal ip address.
  1115. # The source Gitblit instance will also append your external IP address to your
  1116. # identification to differentiate multiple pulling systems behind a single proxy.
  1117. #
  1118. # SINCE 0.6.0
  1119. federation.name =
  1120. # Specify the passphrase of this Gitblit instance.
  1121. #
  1122. # An unspecified (empty) passphrase disables processing federation requests.
  1123. #
  1124. # This value can be anything you want: an integer, a sentence, an haiku, etc.
  1125. # Keep the value simple, though, to avoid Java properties file encoding issues.
  1126. #
  1127. # Changing your passphrase will break any registrations you have established with other
  1128. # Gitblit instances.
  1129. #
  1130. # CASE-SENSITIVE
  1131. # SINCE 0.6.0
  1132. # RESTART REQUIRED *(only to enable or disable federation)*
  1133. federation.passphrase =
  1134. # Control whether or not this Gitblit instance can receive federation proposals
  1135. # from another Gitblit instance. Registering a federated Gitblit is a manual
  1136. # process. Proposals help to simplify that process by allowing a remote Gitblit
  1137. # instance to send your Gitblit instance the federation pull data.
  1138. #
  1139. # SINCE 0.6.0
  1140. federation.allowProposals = false
  1141. # The destination folder for cached federation proposals.
  1142. # Use forward slashes even on Windows!!
  1143. #
  1144. # SINCE 0.6.0
  1145. # BASEFOLDER
  1146. federation.proposalsFolder = ${baseFolder}/proposals
  1147. # The default pull frequency if frequency is unspecified on a registration
  1148. #
  1149. # SINCE 0.6.0
  1150. federation.defaultFrequency = 60 mins
  1151. # Federation Sets are named groups of repositories. The Federation Sets are
  1152. # available for selection in the repository settings page. You can assign a
  1153. # repository to one or more sets and then distribute the token for the set.
  1154. # This allows you to grant federation pull access to a subset of your available
  1155. # repositories. Tokens for federation sets only grant repository pull access.
  1156. #
  1157. # SPACE-DELIMITED
  1158. # CASE-SENSITIVE
  1159. # SINCE 0.6.0
  1160. federation.sets =
  1161. # Federation pull registrations
  1162. # Registrations are read once, at startup.
  1163. #
  1164. # RESTART REQUIRED
  1165. #
  1166. # frequency:
  1167. # The shortest frequency allowed is every 5 minutes
  1168. # Decimal frequency values are cast to integers
  1169. # Frequency values may be specified in mins, hours, or days
  1170. # Values that can not be parsed or are unspecified default to *federation.defaultFrequency*
  1171. #
  1172. # folder:
  1173. # if unspecified, the folder is *git.repositoriesFolder*
  1174. # if specified, the folder is relative to *git.repositoriesFolder*
  1175. #
  1176. # bare:
  1177. # if true, each repository will be created as a *bare* repository and will not
  1178. # have a working directory.
  1179. #
  1180. # if false, each repository will be created as a normal repository suitable
  1181. # for local work.
  1182. #
  1183. # mirror:
  1184. # if true, each repository HEAD is reset to *origin/master* after each pull.
  1185. # The repository will be flagged *isFrozen* after the initial clone.
  1186. #
  1187. # if false, each repository HEAD will point to the FETCH_HEAD of the initial
  1188. # clone from the origin until pushed to or otherwise manipulated.
  1189. #
  1190. # mergeAccounts:
  1191. # if true, remote accounts and their permissions are merged into your
  1192. # users.properties file
  1193. #
  1194. # notifyOnError:
  1195. # if true and the mail configuration is properly set, administrators will be
  1196. # notified by email of pull failures
  1197. #
  1198. # include and exclude:
  1199. # Space-delimited list of repositories to include or exclude from pull
  1200. # may be * wildcard to include or exclude all
  1201. # may use fuzzy match (e.g. org.eclipse.*)
  1202. #
  1203. # (Nearly) Perfect Mirror example
  1204. #
  1205. #federation.example1.url = https://go.gitblit.com
  1206. #federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4
  1207. #federation.example1.frequency = 120 mins
  1208. #federation.example1.folder =
  1209. #federation.example1.bare = true
  1210. #federation.example1.mirror = true
  1211. #federation.example1.mergeAccounts = true
  1212. #
  1213. # Advanced Realm Settings
  1214. #
  1215. # Auto-creates user accounts based on the servlet container principal. This
  1216. # assumes that your Gitblit install is a protected resource and your container's
  1217. # authentication process intercepts all Gitblit requests.
  1218. #
  1219. # SINCE 1.3.0
  1220. realm.container.autoCreateAccounts = false
  1221. # Allow or prohibit Windows guest account logins
  1222. #
  1223. # SINCE 1.3.0
  1224. realm.windows.allowGuests = false
  1225. # Allow user accounts belonging to the BUILTIN\Administrators group to be
  1226. # Gitblit administrators.
  1227. #
  1228. # SINCE 1.4.0
  1229. realm.windows.permitBuiltInAdministrators = true
  1230. # The default domain for authentication.
  1231. #
  1232. # If specified, this domain will be used for authentication UNLESS the supplied
  1233. # login name manually specifies a domain (.e.g. mydomain\james or james@mydomain)
  1234. #
  1235. # If unspecified, the username must be specified in UPN format (name@domain).
  1236. #
  1237. # if "." (dot) is specified, ONLY the local account database will be used.
  1238. #
  1239. # SINCE 1.3.0
  1240. realm.windows.defaultDomain =
  1241. # The PAM service name for authentication.
  1242. # default: system-auth
  1243. #
  1244. # SINCE 1.3.1
  1245. realm.pam.serviceName = system-auth
  1246. # The Apache htpasswd file that contains the users and passwords.
  1247. # default: ${baseFolder}/htpasswd
  1248. #
  1249. # RESTART REQUIRED
  1250. # BASEFOLDER
  1251. # SINCE 1.3.2
  1252. realm.htpasswd.userfile = ${baseFolder}/htpasswd
  1253. # Restrict the Salesforce user to members of this org.
  1254. # default: 0 (i.e. do not check the Org ID)
  1255. #
  1256. # SINCE 1.3.0
  1257. realm.salesforce.orgId = 0
  1258. # URL of the LDAP server.
  1259. # To use encrypted transport, use either ldaps:// URL for SSL or ldap+tls:// to
  1260. # send StartTLS command.
  1261. #
  1262. # SINCE 1.0.0
  1263. realm.ldap.server = ldap://localhost
  1264. # Login username for LDAP searches.
  1265. # If this value is unspecified, anonymous LDAP login will be used.
  1266. #
  1267. # e.g. mydomain\\username
  1268. #
  1269. # SINCE 1.0.0
  1270. realm.ldap.username = cn=Directory Manager
  1271. # Login password for LDAP searches.
  1272. #
  1273. # SINCE 1.0.0
  1274. realm.ldap.password = password
  1275. # Delegate team membership control to LDAP.
  1276. #
  1277. # If true, team user memberships will be specified by LDAP groups. This will
  1278. # disable team selection in Edit User and user selection in Edit Team.
  1279. #
  1280. # If false, LDAP will only be used for authentication and Gitblit will maintain
  1281. # team memberships with the *realm.ldap.backingUserService*.
  1282. #
  1283. # SINCE 1.0.0
  1284. realm.ldap.maintainTeams = false
  1285. # Root node for all LDAP users
  1286. #
  1287. # This is the root node from which subtree user searches will begin.
  1288. # If blank, Gitblit will search ALL nodes.
  1289. #
  1290. # SINCE 1.0.0
  1291. realm.ldap.accountBase = OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1292. # Filter criteria for LDAP users
  1293. #
  1294. # Query pattern to use when searching for a user account. This may be any valid
  1295. # LDAP query expression, including the standard (&) and (|) operators.
  1296. #
  1297. # Variables may be injected via the ${variableName} syntax.
  1298. # Recognized variables are:
  1299. # ${username} - The text entered as the user name
  1300. #
  1301. # SINCE 1.0.0
  1302. realm.ldap.accountPattern = (&(objectClass=person)(sAMAccountName=${username}))
  1303. # Root node for all LDAP groups to be used as Gitblit Teams
  1304. #
  1305. # This is the root node from which subtree team searches will begin.
  1306. # If blank, Gitblit will search ALL nodes.
  1307. #
  1308. # SINCE 1.0.0
  1309. realm.ldap.groupBase = OU=Groups,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1310. # Filter criteria for LDAP groups
  1311. #
  1312. # Query pattern to use when searching for a team. This may be any valid
  1313. # LDAP query expression, including the standard (&) and (|) operators.
  1314. #
  1315. # Variables may be injected via the ${variableName} syntax.
  1316. # Recognized variables are:
  1317. # ${username} - The text entered as the user name
  1318. # ${dn} - The Distinguished Name of the user logged in
  1319. #
  1320. # All attributes from the LDAP User record are available. For example, if a user
  1321. # has an attribute "fullName" set to "John", "(fn=${fullName})" will be
  1322. # translated to "(fn=John)".
  1323. #
  1324. # SINCE 1.0.0
  1325. realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))
  1326. # Filter criteria for empty LDAP groups
  1327. #
  1328. # Query pattern to use when searching for an empty team. This may be any valid
  1329. # LDAP query expression, including the standard (&) and (|) operators.
  1330. #
  1331. # default: (&(objectClass=group)(!(member=*)))
  1332. # SINCE 1.4.0
  1333. realm.ldap.groupEmptyMemberPattern = (&(objectClass=group)(!(member=*)))
  1334. # LDAP users or groups that should be given administrator privileges.
  1335. #
  1336. # Teams are specified with a leading '@' character. Groups with spaces in the
  1337. # name can be entered as "@team name". This setting only applies when using
  1338. # LDAP to maintain team memberships.
  1339. #
  1340. # e.g. realm.ldap.admins = john @git_admins "@git admins"
  1341. #
  1342. # SPACE-DELIMITED
  1343. # SINCE 1.0.0
  1344. realm.ldap.admins = @Git_Admins
  1345. # Attribute(s) on the USER record that indicate their display (or full) name.
  1346. # Leave blank for no mapping available in LDAP.
  1347. #
  1348. # This may be a single attribute, or a string of multiple attributes. Examples:
  1349. # displayName - Uses the attribute 'displayName' on the user record
  1350. # ${personalTitle}. ${givenName} ${surname} - Will concatenate the 3
  1351. # attributes together, with a '.' after personalTitle
  1352. #
  1353. # SINCE 1.0.0
  1354. realm.ldap.displayName = displayName
  1355. # Attribute(s) on the USER record that indicate their email address.
  1356. # Leave blank for no mapping available in LDAP.
  1357. #
  1358. # This may be a single attribute, or a string of multiple attributes. Examples:
  1359. # email - Uses the attribute 'email' on the user record
  1360. # ${givenName}.${surname}@gitblit.com -Will concatenate the 2 attributes
  1361. # together with a '.' and '@' creating something like first.last@gitblit.com
  1362. #
  1363. # SINCE 1.0.0
  1364. realm.ldap.email = email
  1365. # Attribute on the USER record that indicate their username to be used in gitblit
  1366. # when synchronizing users from LDAP
  1367. # if blank, Gitblit will use uid
  1368. # For MS Active Directory this may be sAMAccountName
  1369. #
  1370. # SINCE 1.0.0
  1371. realm.ldap.uid = uid
  1372. # Defines whether to synchronize all LDAP users and teams into the user service
  1373. #
  1374. # Valid values: true, false
  1375. # If left blank, false is assumed
  1376. #
  1377. # SINCE 1.4.0
  1378. realm.ldap.synchronize = false
  1379. # Defines the period to be used when synchronizing users and teams from ldap.
  1380. #
  1381. # Must be of the form '<long> <TimeUnit>' where <TimeUnit> is one of 'MILLISECONDS', 'SECONDS', 'MINUTES', 'HOURS', 'DAYS'
  1382. # default: 5 MINUTES
  1383. #
  1384. # RESTART REQUIRED
  1385. # SINCE 1.4.0
  1386. realm.ldap.syncPeriod = 5 MINUTES
  1387. # Defines whether to delete non-existent LDAP users from the user service
  1388. # during synchronization. depends on realm.ldap.synchronize = true
  1389. #
  1390. # Valid values: true, false
  1391. # If left blank, true is assumed
  1392. #
  1393. # SINCE 1.4.0
  1394. realm.ldap.removeDeletedUsers = true
  1395. # URL of the Redmine.
  1396. #
  1397. # SINCE 1.2.0
  1398. realm.redmine.url = http://example.com/redmine
  1399. #
  1400. # Server Settings
  1401. #
  1402. # The temporary folder to decompress the embedded gitblit webapp.
  1403. #
  1404. # SINCE 0.5.0
  1405. # RESTART REQUIRED
  1406. # BASEFOLDER
  1407. server.tempFolder = ${baseFolder}/temp
  1408. # Use Jetty NIO connectors. If false, Jetty Socket connectors will be used.
  1409. #
  1410. # SINCE 0.5.0
  1411. # RESTART REQUIRED
  1412. server.useNio = true
  1413. # Specify the maximum number of concurrent http/https worker threads to allow.
  1414. #
  1415. # SINCE 1.3.0
  1416. # RESTART REQUIRED
  1417. server.threadPoolSize = 50
  1418. # Context path for the GO application. You might want to change the context
  1419. # path if running Gitblit behind a proxy layer such as mod_proxy.
  1420. #
  1421. # SINCE 0.7.0
  1422. # RESTART REQUIRED
  1423. server.contextPath = /
  1424. # Standard http port to serve. <= 0 disables this connector.
  1425. # On Unix/Linux systems, ports < 1024 require root permissions.
  1426. # Recommended value: 80 or 8080
  1427. #
  1428. # SINCE 0.5.0
  1429. # RESTART REQUIRED
  1430. server.httpPort = 0
  1431. # Secure/SSL https port to serve. <= 0 disables this connector.
  1432. # On Unix/Linux systems, ports < 1024 require root permissions.
  1433. # Recommended value: 443 or 8443
  1434. #
  1435. # SINCE 0.5.0
  1436. # RESTART REQUIRED
  1437. server.httpsPort = 8443
  1438. # Port for serving an Apache JServ Protocol (AJP) 1.3 connector for integrating
  1439. # Gitblit GO into an Apache HTTP server setup. <= 0 disables this connector.
  1440. # Recommended value: 8009
  1441. #
  1442. # SINCE 0.9.0
  1443. # RESTART REQUIRED
  1444. server.ajpPort = 0
  1445. # Automatically redirect http requests to the secure https connector.
  1446. #
  1447. # This setting requires that you have configured server.httpPort and server.httpsPort.
  1448. # Unless you are on a private LAN where you trust all client connections, it is
  1449. # recommended to use https for all communications.
  1450. #
  1451. # SINCE 1.4.0
  1452. # RESTART REQUIRED
  1453. server.redirectToHttpsPort = false
  1454. # Specify the interface for Jetty to bind the standard connector.
  1455. # You may specify an ip or an empty value to bind to all interfaces.
  1456. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1457. # localhost.
  1458. #
  1459. # SINCE 0.5.0
  1460. # RESTART REQUIRED
  1461. server.httpBindInterface =
  1462. # Specify the interface for Jetty to bind the secure connector.
  1463. # You may specify an ip or an empty value to bind to all interfaces.
  1464. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1465. # localhost.
  1466. #
  1467. # SINCE 0.5.0
  1468. # RESTART REQUIRED
  1469. server.httpsBindInterface =
  1470. # Specify the interface for Jetty to bind the AJP connector.
  1471. # You may specify an ip or an empty value to bind to all interfaces.
  1472. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1473. # localhost.
  1474. #
  1475. # SINCE 0.9.0
  1476. # RESTART REQUIRED
  1477. server.ajpBindInterface = localhost
  1478. # Alias of certificate to use for https/SSL serving. If blank the first
  1479. # certificate found in the keystore will be used.
  1480. #
  1481. # SINCE 1.2.0
  1482. # RESTART REQUIRED
  1483. server.certificateAlias = localhost
  1484. # Password for SSL keystore.
  1485. # Keystore password and certificate password must match.
  1486. # This is provided for convenience, its probably more secure to set this value
  1487. # using the --storePassword command line parameter.
  1488. #
  1489. # If you are using the official JRE or JDK from Oracle you may not have the
  1490. # JCE Unlimited Strength Jurisdiction Policy files bundled with your JVM. Because
  1491. # of this, your store/key password can not exceed 7 characters. If you require
  1492. # longer passwords you may need to install the JCE Unlimited Strength Jurisdiction
  1493. # Policy files from Oracle.
  1494. #
  1495. # http://www.oracle.com/technetwork/java/javase/downloads/index.html
  1496. #
  1497. # Gitblit and the Gitblit Certificate Authority will both indicate if Unlimited
  1498. # Strength encryption is available.
  1499. #
  1500. # SINCE 0.5.0
  1501. # RESTART REQUIRED
  1502. server.storePassword = gitblit
  1503. # If serving over https (recommended) you might consider requiring clients to
  1504. # authenticate with ssl certificates. If enabled, only https clients with the
  1505. # a valid client certificate will be able to access Gitblit.
  1506. #
  1507. # If disabled, client certificate authentication is optional and will be tried
  1508. # first before falling-back to form authentication or basic authentication.
  1509. #
  1510. # Requiring client certificates to access any of Gitblit may be too extreme,
  1511. # consider this carefully.
  1512. #
  1513. # SINCE 1.2.0
  1514. # RESTART REQUIRED
  1515. server.requireClientCertificates = false
  1516. # Port for shutdown monitor to listen on.
  1517. #
  1518. # SINCE 0.5.0
  1519. # RESTART REQUIRED
  1520. server.shutdownPort = 8081