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

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715
  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. regex.global = true
  1047. # Example global regex substitutions
  1048. # Use !!! to separate the search pattern and the replace pattern
  1049. # searchpattern!!!replacepattern
  1050. # SINCE 0.5.0
  1051. # regex.global.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://somehost/bug/$3">$3</a>
  1052. # SINCE 0.5.0
  1053. # Example Gerrit links
  1054. # 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>
  1055. # regex.global.reviewedon = \\b(Reviewed-on:\\s*)([A-Za-z0-9:/\\.]*)\\b!!!Reviewed-on: <a href="$2">$2</a>
  1056. # Example per-repository regex substitutions overrides global
  1057. # SINCE 0.5.0
  1058. # regex.myrepository.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://elsewhere/bug/$3">$3</a>
  1059. #
  1060. # Mail Settings
  1061. # SINCE 0.6.0
  1062. #
  1063. # Mail settings are used to notify administrators of received federation proposals
  1064. #
  1065. # ip or hostname of smtp server
  1066. #
  1067. # SINCE 0.6.0
  1068. mail.server =
  1069. # port to use for smtp requests
  1070. #
  1071. # SINCE 0.6.0
  1072. mail.port = 25
  1073. # debug the mail executor
  1074. #
  1075. # SINCE 0.6.0
  1076. mail.debug = false
  1077. # use SMTPs flag
  1078. mail.smtps = false
  1079. # if your smtp server requires authentication, supply the credentials here
  1080. #
  1081. # SINCE 0.6.0
  1082. mail.username =
  1083. # SINCE 0.6.0
  1084. mail.password =
  1085. # from address for generated emails
  1086. #
  1087. # SINCE 0.6.0
  1088. mail.fromAddress =
  1089. # List of email addresses for the Gitblit administrators
  1090. #
  1091. # SPACE-DELIMITED
  1092. # SINCE 0.6.0
  1093. mail.adminAddresses =
  1094. # List of email addresses for sending push email notifications.
  1095. #
  1096. # This key currently requires use of the sendemail.groovy hook script.
  1097. # If you set sendemail.groovy in *groovy.postReceiveScripts* then email
  1098. # notifications for all repositories (regardless of access restrictions!)
  1099. # will be sent to these addresses.
  1100. #
  1101. # SPACE-DELIMITED
  1102. # SINCE 0.8.0
  1103. mail.mailingLists =
  1104. #
  1105. # Federation Settings
  1106. # SINCE 0.6.0
  1107. #
  1108. # A Gitblit federation is a way to backup one Gitblit instance to another.
  1109. #
  1110. # *git.enableGitServlet* must be true to use this feature.
  1111. # Your federation name is used for federation status acknowledgments. If it is
  1112. # unset, and you elect to send a status acknowledgment, your Gitblit instance
  1113. # will be identified by its hostname, if available, else your internal ip address.
  1114. # The source Gitblit instance will also append your external IP address to your
  1115. # identification to differentiate multiple pulling systems behind a single proxy.
  1116. #
  1117. # SINCE 0.6.0
  1118. federation.name =
  1119. # Specify the passphrase of this Gitblit instance.
  1120. #
  1121. # An unspecified (empty) passphrase disables processing federation requests.
  1122. #
  1123. # This value can be anything you want: an integer, a sentence, an haiku, etc.
  1124. # Keep the value simple, though, to avoid Java properties file encoding issues.
  1125. #
  1126. # Changing your passphrase will break any registrations you have established with other
  1127. # Gitblit instances.
  1128. #
  1129. # CASE-SENSITIVE
  1130. # SINCE 0.6.0
  1131. # RESTART REQUIRED *(only to enable or disable federation)*
  1132. federation.passphrase =
  1133. # Control whether or not this Gitblit instance can receive federation proposals
  1134. # from another Gitblit instance. Registering a federated Gitblit is a manual
  1135. # process. Proposals help to simplify that process by allowing a remote Gitblit
  1136. # instance to send your Gitblit instance the federation pull data.
  1137. #
  1138. # SINCE 0.6.0
  1139. federation.allowProposals = false
  1140. # The destination folder for cached federation proposals.
  1141. # Use forward slashes even on Windows!!
  1142. #
  1143. # SINCE 0.6.0
  1144. # BASEFOLDER
  1145. federation.proposalsFolder = ${baseFolder}/proposals
  1146. # The default pull frequency if frequency is unspecified on a registration
  1147. #
  1148. # SINCE 0.6.0
  1149. federation.defaultFrequency = 60 mins
  1150. # Federation Sets are named groups of repositories. The Federation Sets are
  1151. # available for selection in the repository settings page. You can assign a
  1152. # repository to one or more sets and then distribute the token for the set.
  1153. # This allows you to grant federation pull access to a subset of your available
  1154. # repositories. Tokens for federation sets only grant repository pull access.
  1155. #
  1156. # SPACE-DELIMITED
  1157. # CASE-SENSITIVE
  1158. # SINCE 0.6.0
  1159. federation.sets =
  1160. # Federation pull registrations
  1161. # Registrations are read once, at startup.
  1162. #
  1163. # RESTART REQUIRED
  1164. #
  1165. # frequency:
  1166. # The shortest frequency allowed is every 5 minutes
  1167. # Decimal frequency values are cast to integers
  1168. # Frequency values may be specified in mins, hours, or days
  1169. # Values that can not be parsed or are unspecified default to *federation.defaultFrequency*
  1170. #
  1171. # folder:
  1172. # if unspecified, the folder is *git.repositoriesFolder*
  1173. # if specified, the folder is relative to *git.repositoriesFolder*
  1174. #
  1175. # bare:
  1176. # if true, each repository will be created as a *bare* repository and will not
  1177. # have a working directory.
  1178. #
  1179. # if false, each repository will be created as a normal repository suitable
  1180. # for local work.
  1181. #
  1182. # mirror:
  1183. # if true, each repository HEAD is reset to *origin/master* after each pull.
  1184. # The repository will be flagged *isFrozen* after the initial clone.
  1185. #
  1186. # if false, each repository HEAD will point to the FETCH_HEAD of the initial
  1187. # clone from the origin until pushed to or otherwise manipulated.
  1188. #
  1189. # mergeAccounts:
  1190. # if true, remote accounts and their permissions are merged into your
  1191. # users.properties file
  1192. #
  1193. # notifyOnError:
  1194. # if true and the mail configuration is properly set, administrators will be
  1195. # notified by email of pull failures
  1196. #
  1197. # include and exclude:
  1198. # Space-delimited list of repositories to include or exclude from pull
  1199. # may be * wildcard to include or exclude all
  1200. # may use fuzzy match (e.g. org.eclipse.*)
  1201. #
  1202. # (Nearly) Perfect Mirror example
  1203. #
  1204. #federation.example1.url = https://go.gitblit.com
  1205. #federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4
  1206. #federation.example1.frequency = 120 mins
  1207. #federation.example1.folder =
  1208. #federation.example1.bare = true
  1209. #federation.example1.mirror = true
  1210. #federation.example1.mergeAccounts = true
  1211. #
  1212. # Advanced Realm Settings
  1213. #
  1214. # Auto-creates user accounts based on the servlet container principal. This
  1215. # assumes that your Gitblit install is a protected resource and your container's
  1216. # authentication process intercepts all Gitblit requests.
  1217. #
  1218. # SINCE 1.3.0
  1219. realm.container.autoCreateAccounts = false
  1220. # Allow or prohibit Windows guest account logins
  1221. #
  1222. # SINCE 1.3.0
  1223. realm.windows.allowGuests = false
  1224. # Allow user accounts belonging to the BUILTIN\Administrators group to be
  1225. # Gitblit administrators.
  1226. #
  1227. # SINCE 1.4.0
  1228. realm.windows.permitBuiltInAdministrators = true
  1229. # The default domain for authentication.
  1230. #
  1231. # If specified, this domain will be used for authentication UNLESS the supplied
  1232. # login name manually specifies a domain (.e.g. mydomain\james or james@mydomain)
  1233. #
  1234. # If unspecified, the username must be specified in UPN format (name@domain).
  1235. #
  1236. # if "." (dot) is specified, ONLY the local account database will be used.
  1237. #
  1238. # SINCE 1.3.0
  1239. realm.windows.defaultDomain =
  1240. # The PAM service name for authentication.
  1241. # default: system-auth
  1242. #
  1243. # SINCE 1.3.1
  1244. realm.pam.serviceName = system-auth
  1245. # The Apache htpasswd file that contains the users and passwords.
  1246. # default: ${baseFolder}/htpasswd
  1247. #
  1248. # RESTART REQUIRED
  1249. # BASEFOLDER
  1250. # SINCE 1.3.2
  1251. realm.htpasswd.userfile = ${baseFolder}/htpasswd
  1252. # Restrict the Salesforce user to members of this org.
  1253. # default: 0 (i.e. do not check the Org ID)
  1254. #
  1255. # SINCE 1.3.0
  1256. realm.salesforce.orgId = 0
  1257. # URL of the LDAP server.
  1258. # To use encrypted transport, use either ldaps:// URL for SSL or ldap+tls:// to
  1259. # send StartTLS command.
  1260. #
  1261. # SINCE 1.0.0
  1262. realm.ldap.server = ldap://localhost
  1263. # Login username for LDAP searches.
  1264. # If this value is unspecified, anonymous LDAP login will be used.
  1265. #
  1266. # e.g. mydomain\\username
  1267. #
  1268. # SINCE 1.0.0
  1269. realm.ldap.username = cn=Directory Manager
  1270. # Login password for LDAP searches.
  1271. #
  1272. # SINCE 1.0.0
  1273. realm.ldap.password = password
  1274. # Delegate team membership control to LDAP.
  1275. #
  1276. # If true, team user memberships will be specified by LDAP groups. This will
  1277. # disable team selection in Edit User and user selection in Edit Team.
  1278. #
  1279. # If false, LDAP will only be used for authentication and Gitblit will maintain
  1280. # team memberships with the *realm.ldap.backingUserService*.
  1281. #
  1282. # SINCE 1.0.0
  1283. realm.ldap.maintainTeams = false
  1284. # Root node for all LDAP users
  1285. #
  1286. # This is the root node from which subtree user searches will begin.
  1287. # If blank, Gitblit will search ALL nodes.
  1288. #
  1289. # SINCE 1.0.0
  1290. realm.ldap.accountBase = OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1291. # Filter criteria for LDAP users
  1292. #
  1293. # Query pattern to use when searching for a user account. This may be any valid
  1294. # LDAP query expression, including the standard (&) and (|) operators.
  1295. #
  1296. # Variables may be injected via the ${variableName} syntax.
  1297. # Recognized variables are:
  1298. # ${username} - The text entered as the user name
  1299. #
  1300. # SINCE 1.0.0
  1301. realm.ldap.accountPattern = (&(objectClass=person)(sAMAccountName=${username}))
  1302. # Root node for all LDAP groups to be used as Gitblit Teams
  1303. #
  1304. # This is the root node from which subtree team searches will begin.
  1305. # If blank, Gitblit will search ALL nodes.
  1306. #
  1307. # SINCE 1.0.0
  1308. realm.ldap.groupBase = OU=Groups,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1309. # Filter criteria for LDAP groups
  1310. #
  1311. # Query pattern to use when searching for a team. This may be any valid
  1312. # LDAP query expression, including the standard (&) and (|) operators.
  1313. #
  1314. # Variables may be injected via the ${variableName} syntax.
  1315. # Recognized variables are:
  1316. # ${username} - The text entered as the user name
  1317. # ${dn} - The Distinguished Name of the user logged in
  1318. #
  1319. # All attributes from the LDAP User record are available. For example, if a user
  1320. # has an attribute "fullName" set to "John", "(fn=${fullName})" will be
  1321. # translated to "(fn=John)".
  1322. #
  1323. # SINCE 1.0.0
  1324. realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))
  1325. # Filter criteria for empty LDAP groups
  1326. #
  1327. # Query pattern to use when searching for an empty team. This may be any valid
  1328. # LDAP query expression, including the standard (&) and (|) operators.
  1329. #
  1330. # default: (&(objectClass=group)(!(member=*)))
  1331. # SINCE 1.4.0
  1332. realm.ldap.groupEmptyMemberPattern = (&(objectClass=group)(!(member=*)))
  1333. # LDAP users or groups that should be given administrator privileges.
  1334. #
  1335. # Teams are specified with a leading '@' character. Groups with spaces in the
  1336. # name can be entered as "@team name". This setting only applies when using
  1337. # LDAP to maintain team memberships.
  1338. #
  1339. # e.g. realm.ldap.admins = john @git_admins "@git admins"
  1340. #
  1341. # SPACE-DELIMITED
  1342. # SINCE 1.0.0
  1343. realm.ldap.admins = @Git_Admins
  1344. # Attribute(s) on the USER record that indicate their display (or full) name.
  1345. # Leave blank for no mapping available in LDAP.
  1346. #
  1347. # This may be a single attribute, or a string of multiple attributes. Examples:
  1348. # displayName - Uses the attribute 'displayName' on the user record
  1349. # ${personalTitle}. ${givenName} ${surname} - Will concatenate the 3
  1350. # attributes together, with a '.' after personalTitle
  1351. #
  1352. # SINCE 1.0.0
  1353. realm.ldap.displayName = displayName
  1354. # Attribute(s) on the USER record that indicate their email address.
  1355. # Leave blank for no mapping available in LDAP.
  1356. #
  1357. # This may be a single attribute, or a string of multiple attributes. Examples:
  1358. # email - Uses the attribute 'email' on the user record
  1359. # ${givenName}.${surname}@gitblit.com -Will concatenate the 2 attributes
  1360. # together with a '.' and '@' creating something like first.last@gitblit.com
  1361. #
  1362. # SINCE 1.0.0
  1363. realm.ldap.email = email
  1364. # Attribute on the USER record that indicate their username to be used in gitblit
  1365. # when synchronizing users from LDAP
  1366. # if blank, Gitblit will use uid
  1367. # For MS Active Directory this may be sAMAccountName
  1368. #
  1369. # SINCE 1.0.0
  1370. realm.ldap.uid = uid
  1371. # Defines whether to synchronize all LDAP users and teams into the user service
  1372. #
  1373. # Valid values: true, false
  1374. # If left blank, false is assumed
  1375. #
  1376. # SINCE 1.4.0
  1377. realm.ldap.synchronize = false
  1378. # Defines the period to be used when synchronizing users and teams from ldap.
  1379. #
  1380. # Must be of the form '<long> <TimeUnit>' where <TimeUnit> is one of 'MILLISECONDS', 'SECONDS', 'MINUTES', 'HOURS', 'DAYS'
  1381. # default: 5 MINUTES
  1382. #
  1383. # RESTART REQUIRED
  1384. # SINCE 1.4.0
  1385. realm.ldap.syncPeriod = 5 MINUTES
  1386. # Defines whether to delete non-existent LDAP users from the user service
  1387. # during synchronization. depends on realm.ldap.synchronize = true
  1388. #
  1389. # Valid values: true, false
  1390. # If left blank, true is assumed
  1391. #
  1392. # SINCE 1.4.0
  1393. realm.ldap.removeDeletedUsers = true
  1394. # URL of the Redmine.
  1395. #
  1396. # SINCE 1.2.0
  1397. realm.redmine.url = http://example.com/redmine
  1398. #
  1399. # Server Settings
  1400. #
  1401. # The temporary folder to decompress the embedded gitblit webapp.
  1402. #
  1403. # SINCE 0.5.0
  1404. # RESTART REQUIRED
  1405. # BASEFOLDER
  1406. server.tempFolder = ${baseFolder}/temp
  1407. # Use Jetty NIO connectors. If false, Jetty Socket connectors will be used.
  1408. #
  1409. # SINCE 0.5.0
  1410. # RESTART REQUIRED
  1411. server.useNio = true
  1412. # Specify the maximum number of concurrent http/https worker threads to allow.
  1413. #
  1414. # SINCE 1.3.0
  1415. # RESTART REQUIRED
  1416. server.threadPoolSize = 50
  1417. # Context path for the GO application. You might want to change the context
  1418. # path if running Gitblit behind a proxy layer such as mod_proxy.
  1419. #
  1420. # SINCE 0.7.0
  1421. # RESTART REQUIRED
  1422. server.contextPath = /
  1423. # Standard http port to serve. <= 0 disables this connector.
  1424. # On Unix/Linux systems, ports < 1024 require root permissions.
  1425. # Recommended value: 80 or 8080
  1426. #
  1427. # SINCE 0.5.0
  1428. # RESTART REQUIRED
  1429. server.httpPort = 0
  1430. # Secure/SSL https port to serve. <= 0 disables this connector.
  1431. # On Unix/Linux systems, ports < 1024 require root permissions.
  1432. # Recommended value: 443 or 8443
  1433. #
  1434. # SINCE 0.5.0
  1435. # RESTART REQUIRED
  1436. server.httpsPort = 8443
  1437. # Port for serving an Apache JServ Protocol (AJP) 1.3 connector for integrating
  1438. # Gitblit GO into an Apache HTTP server setup. <= 0 disables this connector.
  1439. # Recommended value: 8009
  1440. #
  1441. # SINCE 0.9.0
  1442. # RESTART REQUIRED
  1443. server.ajpPort = 0
  1444. # Automatically redirect http requests to the secure https connector.
  1445. #
  1446. # This setting requires that you have configured server.httpPort and server.httpsPort.
  1447. # Unless you are on a private LAN where you trust all client connections, it is
  1448. # recommended to use https for all communications.
  1449. #
  1450. # SINCE 1.4.0
  1451. # RESTART REQUIRED
  1452. server.redirectToHttpsPort = false
  1453. # Specify the interface for Jetty to bind the standard connector.
  1454. # You may specify an ip or an empty value to bind to all interfaces.
  1455. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1456. # localhost.
  1457. #
  1458. # SINCE 0.5.0
  1459. # RESTART REQUIRED
  1460. server.httpBindInterface =
  1461. # Specify the interface for Jetty to bind the secure connector.
  1462. # You may specify an ip or an empty value to bind to all interfaces.
  1463. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1464. # localhost.
  1465. #
  1466. # SINCE 0.5.0
  1467. # RESTART REQUIRED
  1468. server.httpsBindInterface =
  1469. # Specify the interface for Jetty to bind the AJP connector.
  1470. # You may specify an ip or an empty value to bind to all interfaces.
  1471. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1472. # localhost.
  1473. #
  1474. # SINCE 0.9.0
  1475. # RESTART REQUIRED
  1476. server.ajpBindInterface = localhost
  1477. # Alias of certificate to use for https/SSL serving. If blank the first
  1478. # certificate found in the keystore will be used.
  1479. #
  1480. # SINCE 1.2.0
  1481. # RESTART REQUIRED
  1482. server.certificateAlias = localhost
  1483. # Password for SSL keystore.
  1484. # Keystore password and certificate password must match.
  1485. # This is provided for convenience, its probably more secure to set this value
  1486. # using the --storePassword command line parameter.
  1487. #
  1488. # If you are using the official JRE or JDK from Oracle you may not have the
  1489. # JCE Unlimited Strength Jurisdiction Policy files bundled with your JVM. Because
  1490. # of this, your store/key password can not exceed 7 characters. If you require
  1491. # longer passwords you may need to install the JCE Unlimited Strength Jurisdiction
  1492. # Policy files from Oracle.
  1493. #
  1494. # http://www.oracle.com/technetwork/java/javase/downloads/index.html
  1495. #
  1496. # Gitblit and the Gitblit Certificate Authority will both indicate if Unlimited
  1497. # Strength encryption is available.
  1498. #
  1499. # SINCE 0.5.0
  1500. # RESTART REQUIRED
  1501. server.storePassword = gitblit
  1502. # If serving over https (recommended) you might consider requiring clients to
  1503. # authenticate with ssl certificates. If enabled, only https clients with the
  1504. # a valid client certificate will be able to access Gitblit.
  1505. #
  1506. # If disabled, client certificate authentication is optional and will be tried
  1507. # first before falling-back to form authentication or basic authentication.
  1508. #
  1509. # Requiring client certificates to access any of Gitblit may be too extreme,
  1510. # consider this carefully.
  1511. #
  1512. # SINCE 1.2.0
  1513. # RESTART REQUIRED
  1514. server.requireClientCertificates = false
  1515. # Port for shutdown monitor to listen on.
  1516. #
  1517. # SINCE 0.5.0
  1518. # RESTART REQUIRED
  1519. server.shutdownPort = 8081