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 54KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681
  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. # SINCE 1.0.0
  353. # RESTART REQUIRED
  354. git.streamFileThreshold = 50m
  355. # When true, JGit will use mmap() rather than malloc()+read() to load data from
  356. # pack files. The use of mmap can be problematic on some JVMs as the garbage
  357. # collector must deduce that a memory mapped segment is no longer in use before
  358. # a call to munmap() can be made by the JVM native code.
  359. #
  360. # In server applications (such as Gitblit) that need to access many pack files,
  361. # setting this to true risks artificially running out of virtual address space,
  362. # as the garbage collector cannot reclaim unused mapped spaces fast enough.
  363. #
  364. # Default on JGit is false. Although potentially slower, it yields much more
  365. # predictable behavior.
  366. # Documentation courtesy of the Gerrit project.
  367. #
  368. # SINCE 1.0.0
  369. # RESTART REQUIRED
  370. git.packedGitMmap = false
  371. #
  372. # Groovy Integration
  373. #
  374. # Location of Groovy scripts to use for Pre and Post receive hooks.
  375. # Use forward slashes even on Windows!!
  376. # e.g. c:/groovy
  377. #
  378. # RESTART REQUIRED
  379. # SINCE 0.8.0
  380. # BASEFOLDER
  381. groovy.scriptsFolder = ${baseFolder}/groovy
  382. # Specify the directory Grape uses for downloading libraries.
  383. # http://groovy.codehaus.org/Grape
  384. #
  385. # RESTART REQUIRED
  386. # SINCE 1.0.0
  387. # BASEFOLDER
  388. groovy.grapeFolder = ${baseFolder}/groovy/grape
  389. # Scripts to execute on Pre-Receive.
  390. #
  391. # These scripts execute after an incoming push has been parsed and validated
  392. # but BEFORE the changes are applied to the repository. You might reject a
  393. # push in this script based on the repository and branch the push is attempting
  394. # to change.
  395. #
  396. # Script names are case-sensitive on case-sensitive file systems. You may omit
  397. # the traditional ".groovy" from this list if your file extension is ".groovy"
  398. #
  399. # NOTE:
  400. # These scripts are only executed when pushing to *Gitblit*, not to other Git
  401. # tooling you may be using. Also note that these scripts are shared between
  402. # repositories. These are NOT repository-specific scripts! Within the script
  403. # you may customize the control-flow for a specific repository by checking the
  404. # *repository* variable.
  405. #
  406. # SPACE-DELIMITED
  407. # CASE-SENSITIVE
  408. # SINCE 0.8.0
  409. groovy.preReceiveScripts =
  410. # Scripts to execute on Post-Receive.
  411. #
  412. # These scripts execute AFTER an incoming push has been applied to a repository.
  413. # You might trigger a continuous-integration build here or send a notification.
  414. #
  415. # Script names are case-sensitive on case-sensitive file systems. You may omit
  416. # the traditional ".groovy" from this list if your file extension is ".groovy"
  417. #
  418. # NOTE:
  419. # These scripts are only executed when pushing to *Gitblit*, not to other Git
  420. # tooling you may be using. Also note that these scripts are shared between
  421. # repositories. These are NOT repository-specific scripts! Within the script
  422. # you may customize the control-flow for a specific repository by checking the
  423. # *repository* variable.
  424. #
  425. # SPACE-DELIMITED
  426. # CASE-SENSITIVE
  427. # SINCE 0.8.0
  428. groovy.postReceiveScripts =
  429. # Repository custom fields for Groovy Hook mechanism
  430. #
  431. # List of key=label pairs of custom fields to prompt for in the Edit Repository
  432. # page. These keys are stored in the repository's git config file in the
  433. # section [gitblit "customFields"]. Key names are alphanumeric only. These
  434. # fields are intended to be used for the Groovy hook mechanism where a script
  435. # can adjust it's execution based on the custom fields stored in the repository
  436. # config.
  437. #
  438. # e.g. "commitMsgRegex=Commit Message Regular Expression" anotherProperty=Another
  439. #
  440. # SPACE-DELIMITED
  441. # SINCE 1.0.0
  442. groovy.customFields =
  443. #
  444. # Fanout Settings
  445. #
  446. # Fanout is a PubSub notification service that can be used by Sparkleshare
  447. # to eliminate repository change polling. The fanout service runs in a separate
  448. # thread on a separate port from the Gitblit http/https application.
  449. # This service is provided so that Sparkleshare may be used with Gitblit in
  450. # firewalled environments or where reliance on Sparkleshare's default notifications
  451. # server (notifications.sparkleshare.org) is unwanted.
  452. #
  453. # This service maintains an open socket connection from the client to the
  454. # Fanout PubSub service. This service may not work properly behind a proxy server.
  455. # Specify the interface for Fanout to bind it's service.
  456. # You may specify an ip or an empty value to bind to all interfaces.
  457. # Specifying localhost will result in Gitblit ONLY listening to requests to
  458. # localhost.
  459. #
  460. # SINCE 1.2.1
  461. # RESTART REQUIRED
  462. fanout.bindInterface = localhost
  463. # port for serving the Fanout PubSub service. <= 0 disables this service.
  464. # On Unix/Linux systems, ports < 1024 require root permissions.
  465. # Recommended value: 17000
  466. #
  467. # SINCE 1.2.1
  468. # RESTART REQUIRED
  469. fanout.port = 0
  470. # Use Fanout NIO service. If false, a multi-threaded socket service will be used.
  471. # Be advised, the socket implementation spawns a thread per connection plus the
  472. # connection acceptor thread. The NIO implementation is completely single-threaded.
  473. #
  474. # SINCE 1.2.1
  475. # RESTART REQUIRED
  476. fanout.useNio = true
  477. # Concurrent connection limit. <= 0 disables concurrent connection throttling.
  478. # If > 0, only the specified number of concurrent connections will be allowed
  479. # and all other connections will be rejected.
  480. #
  481. # SINCE 1.2.1
  482. # RESTART REQUIRED
  483. fanout.connectionLimit = 0
  484. #
  485. # Authentication Settings
  486. #
  487. # Require authentication to see everything but the admin pages
  488. #
  489. # SINCE 0.5.0
  490. # RESTART REQUIRED
  491. web.authenticateViewPages = false
  492. # If web.authenticateViewPages=true you may optionally require a client-side
  493. # basic authentication prompt instead of the standard form-based login.
  494. #
  495. # SINCE 1.3.0
  496. web.enforceHttpBasicAuthentication = false
  497. # Require admin authentication for the admin functions and pages
  498. #
  499. # SINCE 0.5.0
  500. # RESTART REQUIRED
  501. web.authenticateAdminPages = true
  502. # Allow Gitblit to store a cookie in the user's browser for automatic
  503. # authentication. The cookie is generated by the user service.
  504. #
  505. # SINCE 0.5.0
  506. web.allowCookieAuthentication = true
  507. # Config file for storing project metadata
  508. #
  509. # SINCE 1.2.0
  510. # BASEFOLDER
  511. web.projectsFile = ${baseFolder}/projects.conf
  512. # Either the full path to a user config file (users.conf)
  513. # OR a fully qualified class name that implements the IUserService interface.
  514. #
  515. # Any custom user service implementation must have a public default constructor.
  516. #
  517. # SINCE 0.5.0
  518. # RESTART REQUIRED
  519. # BASEFOLDER
  520. realm.userService = ${baseFolder}/users.conf
  521. # Ordered list of external authentication providers which will be used if
  522. # authentication against the local user service fails.
  523. #
  524. # Valid providers are:
  525. #
  526. # htpasswd
  527. # ldap
  528. # pam
  529. # redmine
  530. # salesforce
  531. # windows
  532. # e.g. realm.authenticationProviders = htpasswd windows
  533. #
  534. # SINCE 1.4.0
  535. # RESTART REQUIRED
  536. # SPACE-DELIMITED
  537. realm.authenticationProviders =
  538. # How to store passwords.
  539. # Valid values are plain, md5, or combined-md5. md5 is the hash of password.
  540. # combined-md5 is the hash of username.toLowerCase()+password.
  541. # Default is md5.
  542. #
  543. # SINCE 0.5.0
  544. realm.passwordStorage = md5
  545. # Minimum valid length for a plain text password.
  546. # Default value is 5. Absolute minimum is 4.
  547. #
  548. # SINCE 0.5.0
  549. realm.minPasswordLength = 5
  550. #
  551. # Gitblit Web Settings
  552. #
  553. # If blank Gitblit is displayed.
  554. #
  555. # SINCE 0.5.0
  556. web.siteName =
  557. # The canonical url of your Gitblit server to bs used in email notifications.
  558. # e.g. web.canonicalUrl = https://demo-gitblit.rhcloud.com
  559. #
  560. # SINCE 1.4.0
  561. web.canonicalUrl =
  562. # You may specify a different logo image for the header but it must be 120x45px.
  563. # If the specified file does not exist, the default Gitblit logo will be used.
  564. #
  565. # SINCE 1.3.0
  566. # BASEFOLDER
  567. web.headerLogo = ${baseFolder}/logo.png
  568. # You may specify a different link URL for the logo image anchor.
  569. # If blank the Gitblit main page URL is used.
  570. #
  571. # SINCE 1.3.0
  572. # BASEFOLDER
  573. web.rootLink =
  574. # You may specify a custom header background CSS color. If unspecified, the
  575. # default color will be used.
  576. #
  577. # e.g. web.headerBackgroundColor = #002060
  578. #
  579. # SINCE 1.3.0
  580. web.headerBackgroundColor =
  581. # You may specify a custom header foreground CSS color. If unspecified, the
  582. # default color will be used.
  583. #
  584. # e.g. web.headerForegroundColor = white
  585. #
  586. # SINCE 1.3.0
  587. web.headerForegroundColor =
  588. # You may specify a custom header foreground hover CSS color. If unspecified, the
  589. # default color will be used.
  590. #
  591. # e.g. web.headerHoverColor = white
  592. #
  593. # SINCE 1.3.0
  594. web.headerHoverColor =
  595. # You may specify a custom header border CSS color. If unspecified, the default
  596. # color will be used.
  597. #
  598. # e.g. web.headerBorderColor = #002060
  599. #
  600. # SINCE 1.3.0
  601. web.headerBorderColor =
  602. # You may specify a custom header border CSS color. If unspecified, the default
  603. # color will be used.
  604. #
  605. # e.g. web.headerBorderFocusColor = #ff9900
  606. #
  607. # SINCE 1.3.0
  608. web.headerBorderFocusColor =
  609. # If *web.authenticateAdminPages*=true, users with "admin" role can create
  610. # repositories, create users, and edit repository metadata.
  611. #
  612. # If *web.authenticateAdminPages*=false, any user can execute the aforementioned
  613. # functions.
  614. #
  615. # SINCE 0.5.0
  616. web.allowAdministration = true
  617. # Allows rpc clients to list repositories and possibly manage or administer the
  618. # Gitblit server, if the authenticated account has administrator permissions.
  619. # See *web.enableRpcManagement* and *web.enableRpcAdministration*.
  620. #
  621. # SINCE 0.7.0
  622. web.enableRpcServlet = true
  623. # Allows rpc clients to manage repositories and users of the Gitblit instance,
  624. # if the authenticated account has administrator permissions.
  625. # Requires *web.enableRpcServlet=true*.
  626. #
  627. # SINCE 0.7.0
  628. web.enableRpcManagement = false
  629. # Allows rpc clients to control the server settings and monitor the health of this
  630. # this Gitblit instance, if the authenticated account has administrator permissions.
  631. # Requires *web.enableRpcServlet=true* and *web.enableRpcManagement*.
  632. #
  633. # SINCE 0.7.0
  634. web.enableRpcAdministration = false
  635. # Full path to a configurable robots.txt file. With this file you can control
  636. # what parts of your Gitblit server respectable robots are allowed to traverse.
  637. # http://googlewebmastercentral.blogspot.com/2008/06/improving-on-robots-exclusion-protocol.html
  638. #
  639. # SINCE 1.0.0
  640. # BASEFOLDER
  641. web.robots.txt = ${baseFolder}/robots.txt
  642. # The number of minutes to cache a page in the browser since the last request.
  643. # The default value is 0 minutes. A value <= 0 disables all page caching which
  644. # is the default behavior for Gitblit <= 1.3.0.
  645. #
  646. # SINCE 1.3.1
  647. web.pageCacheExpires = 0
  648. # If true, the web ui layout will respond and adapt to the browser's dimensions.
  649. # if false, the web ui will use a 940px fixed-width layout.
  650. # http://twitter.github.com/bootstrap/scaffolding.html#responsive
  651. #
  652. # SINCE 1.0.0
  653. web.useResponsiveLayout = true
  654. # Allow Gravatar images to be displayed in Gitblit pages.
  655. #
  656. # SINCE 0.8.0
  657. web.allowGravatar = true
  658. # Allow dynamic zip downloads.
  659. #
  660. # SINCE 0.5.0
  661. web.allowZipDownloads = true
  662. # If *web.allowZipDownloads=true* the following formats will be displayed for
  663. # download compressed archive links:
  664. #
  665. # zip = standard .zip
  666. # tar = standard tar format (preserves *nix permissions and symlinks)
  667. # gz = gz-compressed tar
  668. # xz = xz-compressed tar
  669. # bzip2 = bzip2-compressed tar
  670. #
  671. # SPACE-DELIMITED
  672. # SINCE 1.2.0
  673. web.compressedDownloads = zip gz
  674. # Allow optional Lucene integration. Lucene indexing is an opt-in feature.
  675. # A repository may specify branches to index with Lucene instead of using Git
  676. # commit traversal. There are scenarios where you may want to completely disable
  677. # Lucene indexing despite a repository specifying indexed branches. One such
  678. # scenario is on a resource-constrained federated Gitblit mirror.
  679. #
  680. # SINCE 0.9.0
  681. web.allowLuceneIndexing = true
  682. # Allows an authenticated user to create forks of a repository
  683. #
  684. # set this to false if you want to disable all fork controls on the web site
  685. #
  686. web.allowForking = true
  687. # Controls the length of shortened commit hash ids
  688. #
  689. # SINCE 1.2.0
  690. web.shortCommitIdLength = 6
  691. # Use Clippy (Flash solution) to provide a copy-to-clipboard button.
  692. # If false, a button with a more primitive JavaScript-based prompt box will
  693. # offer a 3-step (click, ctrl+c, enter) copy-to-clipboard alternative.
  694. #
  695. # SINCE 0.8.0
  696. web.allowFlashCopyToClipboard = true
  697. # Default maximum number of commits that a repository may contribute to the
  698. # activity page, regardless of the selected duration. This setting may be valuable
  699. # for an extremely busy server. This value may also be configed per-repository
  700. # in Edit Repository. 0 disables this throttle.
  701. #
  702. # SINCE 1.2.0
  703. web.maxActivityCommits = 0
  704. # Default number of entries to include in RSS Syndication links
  705. #
  706. # SINCE 0.5.0
  707. web.syndicationEntries = 25
  708. # Show the size of each repository on the repositories page.
  709. # This requires recursive traversal of each repository folder. This may be
  710. # non-performant on some operating systems and/or filesystems.
  711. #
  712. # SINCE 0.5.2
  713. web.showRepositorySizes = true
  714. # List of custom regex expressions that can be displayed in the Filters menu
  715. # of the Repositories and Activity pages. Keep them very simple because you
  716. # are likely to run into encoding issues if they are too complex.
  717. #
  718. # Use !!! to separate the filters
  719. #
  720. # SINCE 0.8.0
  721. web.customFilters =
  722. # Show federation registrations (without token) and the current pull status
  723. # to non-administrator users.
  724. #
  725. # SINCE 0.6.0
  726. web.showFederationRegistrations = false
  727. # This is the message displayed when *web.authenticateViewPages=true*.
  728. # This can point to a file with Markdown content.
  729. # Specifying "gitblit" uses the internal login message.
  730. #
  731. # SINCE 0.7.0
  732. # BASEFOLDER
  733. web.loginMessage = gitblit
  734. # This is the message displayed above the repositories table.
  735. # This can point to a file with Markdown content.
  736. # Specifying "gitblit" uses the internal welcome message.
  737. #
  738. # SINCE 0.5.0
  739. # BASEFOLDER
  740. web.repositoriesMessage = gitblit
  741. # Ordered list of charsets/encodings to use when trying to display a blob.
  742. # If empty, UTF-8 and ISO-8859-1 are used. The server's default charset
  743. # is always appended to the encoding list. If all encodings fail to cleanly
  744. # decode the blob content, UTF-8 will be used with the standard malformed
  745. # input/unmappable character replacement strings.
  746. #
  747. # SPACE-DELIMITED
  748. # SINCE 1.0.0
  749. web.blobEncodings = UTF-8 ISO-8859-1
  750. # Manually set the default timezone to be used by Gitblit for display in the
  751. # web ui. This value is independent of the JVM timezone. Specifying a blank
  752. # value will default to the JVM timezone.
  753. # e.g. America/New_York, US/Pacific, UTC, Europe/Berlin
  754. #
  755. # SINCE 0.9.0
  756. # RESTART REQUIRED
  757. web.timezone =
  758. # Use the client timezone when formatting dates.
  759. # This uses AJAX to determine the browser's timezone and may require more
  760. # server overhead because a Wicket session is created. All Gitblit pages
  761. # attempt to be stateless, if possible.
  762. #
  763. # SINCE 0.5.0
  764. # RESTART REQUIRED
  765. web.useClientTimezone = false
  766. # Time format
  767. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  768. #
  769. # SINCE 0.8.0
  770. web.timeFormat = HH:mm
  771. # Short date format
  772. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  773. #
  774. # SINCE 0.5.0
  775. web.datestampShortFormat = yyyy-MM-dd
  776. # Long date format
  777. #
  778. # SINCE 0.8.0
  779. web.datestampLongFormat = EEEE, MMMM d, yyyy
  780. # Long timestamp format
  781. # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
  782. #
  783. # SINCE 0.5.0
  784. web.datetimestampLongFormat = EEEE, MMMM d, yyyy HH:mm Z
  785. # Mount URL parameters
  786. # This setting controls if pretty or parameter URLs are used.
  787. # i.e.
  788. # if true:
  789. # http://localhost/commit/myrepo/abcdef
  790. # if false:
  791. # http://localhost/commit/?r=myrepo&h=abcdef
  792. #
  793. # SINCE 0.5.0
  794. # RESTART REQUIRED
  795. web.mountParameters = true
  796. # Some servlet containers (e.g. Tomcat >= 6.0.10) disallow '/' (%2F) encoding
  797. # in URLs as a security precaution for proxies. This setting tells Gitblit
  798. # to preemptively replace '/' with '*' or '!' for url string parameters.
  799. #
  800. # <https://issues.apache.org/jira/browse/WICKET-1303>
  801. # <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>
  802. # Add *-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to your
  803. # *CATALINA_OPTS* or to your JVM launch parameters
  804. #
  805. # SINCE 0.5.2
  806. web.forwardSlashCharacter = /
  807. # Show other URLs on the summary page for accessing your git repositories
  808. # Use spaces to separate urls.
  809. #
  810. # {0} is the token for the repository name
  811. # {1} is the token for the username
  812. #
  813. # The username is only practical if you have setup your other git serving
  814. # solutions accounts to have the same username as the Gitblit account.
  815. #
  816. # e.g.
  817. # web.otherUrls = ssh://localhost/git/{0} git://localhost/git/{0} https://{1}@localhost/r/{0}
  818. #
  819. # SPACE-DELIMITED
  820. # SINCE 0.5.0
  821. web.otherUrls =
  822. # Should app-specific clone links be displayed for SourceTree, SparkleShare, etc?
  823. #
  824. # SINCE 1.3.0
  825. web.allowAppCloneLinks = true
  826. # Choose how to present the repositories list.
  827. # grouped = group nested/subfolder repositories together (no sorting)
  828. # flat = flat list of repositories (sorting allowed)
  829. #
  830. # SINCE 0.5.0
  831. web.repositoryListType = grouped
  832. # If using a grouped repository list and there are repositories at the
  833. # root level of your repositories folder, you may specify the displayed
  834. # group name with this setting. This value is only used for web presentation.
  835. #
  836. # SINCE 0.5.0
  837. web.repositoryRootGroupName = main
  838. # Display the repository swatch color next to the repository name link in the
  839. # repositories list.
  840. #
  841. # SINCE 0.8.0
  842. web.repositoryListSwatches = true
  843. # Defines the default commit message renderer. This can be configured
  844. # per-repository.
  845. #
  846. # Valid values are: plain, markdown
  847. #
  848. # SINCE 1.4.0
  849. web.commitMessageRenderer = plain
  850. # Control if email addresses are shown in web ui
  851. #
  852. # SINCE 0.5.0
  853. web.showEmailAddresses = true
  854. # Shows a combobox in the page links header with commit, committer, and author
  855. # search selection. Default search is commit.
  856. #
  857. # SINCE 0.5.0
  858. web.showSearchTypeSelection = false
  859. # Controls display of activity graphs on the dashboard, activity, and summary
  860. # pages. Charting makes use of the external Google Charts API.
  861. #
  862. # SINCE 0.5.0
  863. web.generateActivityGraph = true
  864. # Displays the commits branch graph in the summary page and commits/log page.
  865. #
  866. # SINCE 1.4.0
  867. web.showBranchGraph = true
  868. # The default number of days to show on the activity page.
  869. # Value must exceed 0 else default of 7 is used
  870. #
  871. # SINCE 0.8.0
  872. web.activityDuration = 7
  873. # Choices for days of activity to display.
  874. #
  875. # SPACE-DELIMITED
  876. # SINCE 1.3.0
  877. web.activityDurationChoices = 1 3 7 14 21 28
  878. # Maximum number of days of activity that may be displayed on the activity page.
  879. #
  880. # SINCE 1.3.2
  881. web.activityDurationMaximum = 30
  882. # The number of days of commits to cache in memory for the dashboard, activity,
  883. # and project pages. A value of 0 will disable all caching and will parse commits
  884. # in each repository per-request. If the value > 0 these pages will try to fulfill
  885. # requests using the commit cache. If the request specifies a period which falls
  886. # outside the commit cache window, then the cache will be ignored and the request
  887. # will be fulfilled by brute-force parsing all relevant commits per-repository.
  888. #
  889. # Consider the values specified for *web.activityDurationChoices* when setting
  890. # the cache size AND consider adjusting the JVM -Xmx heap parameter appropriately.
  891. #
  892. # SINCE 1.3.0
  893. # RESTART REQUIRED
  894. web.activityCacheDays = 14
  895. # Case-insensitive list of authors to exclude from metrics. Useful for
  896. # eliminating bots.
  897. #
  898. # SPACE-DELIMITED
  899. # SINCE 1.3.0
  900. web.metricAuthorExclusions =
  901. # The number of commits to display on the summary page
  902. # Value must exceed 0 else default of 20 is used
  903. #
  904. # SINCE 0.5.0
  905. web.summaryCommitCount = 16
  906. # The number of tags/branches to display on the summary page.
  907. # -1 = all tags/branches
  908. # 0 = hide tags/branches
  909. # N = N tags/branches
  910. #
  911. # SINCE 0.5.0
  912. web.summaryRefsCount = 5
  913. # Show a README file, if available, on the summary page.
  914. #
  915. # SINCE 1.4.0
  916. web.summaryShowReadme = false
  917. # The number of items to show on a page before showing the first, prev, next
  918. # pagination links. A default of 50 is used for any invalid value.
  919. #
  920. # SINCE 0.5.0
  921. web.itemsPerPage = 50
  922. # The number of reflog changes to display on the overview page
  923. # Value must exceed 0 else default of 5 is used
  924. #
  925. # SINCE 1.3.0
  926. web.overviewReflogCount = 5
  927. # The number of reflog changes to show on a reflog page before show the first,
  928. # prev, next pagination links. A default of 10 is used for any invalid value.
  929. #
  930. # SINCE 1.3.0
  931. web.reflogChangesPerPage = 10
  932. # Specify the names of documents in the root of your repository to be displayed
  933. # in tabs on your repository docs page. If the name is not found in the root
  934. # then no tab is added. The order specified is the order displayed. Do not
  935. # specify a file extension as the aggregation of markup extensions + txt are used
  936. # in the search algorithm.
  937. #
  938. # SPACE-DELIMITED
  939. # SINCE 1.4.0
  940. web.documents = readme home index changelog contributing submitting_patches copying license notice authors
  941. # Registered file extensions to ignore during Lucene indexing
  942. #
  943. # SPACE-DELIMITED
  944. # SINCE 0.9.0
  945. 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
  946. # Registered extensions for google-code-prettify
  947. #
  948. # SPACE-DELIMITED
  949. # SINCE 0.5.0
  950. 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
  951. # Registered extensions for markdown transformation
  952. #
  953. # SPACE-DELIMITED
  954. # CASE-SENSITIVE
  955. # SINCE 0.5.0
  956. web.markdownExtensions = md mkd markdown MD MKD
  957. # Registered extensions for mediawiki transformation
  958. #
  959. # SPACE-DELIMITED
  960. # CASE-SENSITIVE
  961. # SINCE 1.4.0
  962. web.mediawikiExtensions = mw mediawiki
  963. # Registered extensions for twiki transformation
  964. #
  965. # SPACE-DELIMITED
  966. # CASE-SENSITIVE
  967. # SINCE 1.4.0
  968. web.twikiExtensions = twiki
  969. # Registered extensions for textile transformation
  970. #
  971. # SPACE-DELIMITED
  972. # CASE-SENSITIVE
  973. # SINCE 1.4.0
  974. web.textileExtensions = textile
  975. # Registered extensions for confluence transformation
  976. #
  977. # SPACE-DELIMITED
  978. # CASE-SENSITIVE
  979. # SINCE 1.4.0
  980. web.confluenceExtensions = confluence
  981. # Registered extensions for tracwiki transformation
  982. #
  983. # SPACE-DELIMITED
  984. # CASE-SENSITIVE
  985. # SINCE 1.4.0
  986. web.tracwikiExtensions = tracwiki
  987. # Image extensions
  988. #
  989. # SPACE-DELIMITED
  990. # SINCE 0.5.0
  991. web.imageExtensions = bmp jpg gif png
  992. # Registered extensions for binary blobs
  993. #
  994. # SPACE-DELIMITED
  995. # SINCE 0.5.0
  996. 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
  997. # Aggressive heap management will run the garbage collector on every generated
  998. # page. This slows down page generation a little but improves heap consumption.
  999. #
  1000. # SINCE 0.5.0
  1001. web.aggressiveHeapManagement = false
  1002. # Run the webapp in debug mode
  1003. #
  1004. # SINCE 0.5.0
  1005. # RESTART REQUIRED
  1006. web.debugMode = false
  1007. # Force a default locale for all users, ignoring the browser's settings.
  1008. # An empty value allows Gitblit to use the translation preferred by the browser.
  1009. #
  1010. # Changing this value while the server is running will only affect new sessions.
  1011. #
  1012. # e.g. web.forceDefaultLocale = en
  1013. #
  1014. # SINCE 1.3.0
  1015. web.forceDefaultLocale =
  1016. # Enable/disable global regex substitutions (i.e. shared across repositories)
  1017. #
  1018. # SINCE 0.5.0
  1019. regex.global = true
  1020. # Example global regex substitutions
  1021. # Use !!! to separate the search pattern and the replace pattern
  1022. # searchpattern!!!replacepattern
  1023. # SINCE 0.5.0
  1024. # regex.global.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://somehost/bug/$3">$3</a>
  1025. # SINCE 0.5.0
  1026. # Example Gerrit links
  1027. # 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>
  1028. # regex.global.reviewedon = \\b(Reviewed-on:\\s*)([A-Za-z0-9:/\\.]*)\\b!!!Reviewed-on: <a href="$2">$2</a>
  1029. # Example per-repository regex substitutions overrides global
  1030. # SINCE 0.5.0
  1031. # regex.myrepository.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://elsewhere/bug/$3">$3</a>
  1032. #
  1033. # Mail Settings
  1034. # SINCE 0.6.0
  1035. #
  1036. # Mail settings are used to notify administrators of received federation proposals
  1037. #
  1038. # ip or hostname of smtp server
  1039. #
  1040. # SINCE 0.6.0
  1041. mail.server =
  1042. # port to use for smtp requests
  1043. #
  1044. # SINCE 0.6.0
  1045. mail.port = 25
  1046. # debug the mail executor
  1047. #
  1048. # SINCE 0.6.0
  1049. mail.debug = false
  1050. # use SMTPs flag
  1051. mail.smtps = false
  1052. # if your smtp server requires authentication, supply the credentials here
  1053. #
  1054. # SINCE 0.6.0
  1055. mail.username =
  1056. # SINCE 0.6.0
  1057. mail.password =
  1058. # from address for generated emails
  1059. #
  1060. # SINCE 0.6.0
  1061. mail.fromAddress =
  1062. # List of email addresses for the Gitblit administrators
  1063. #
  1064. # SPACE-DELIMITED
  1065. # SINCE 0.6.0
  1066. mail.adminAddresses =
  1067. # List of email addresses for sending push email notifications.
  1068. #
  1069. # This key currently requires use of the sendemail.groovy hook script.
  1070. # If you set sendemail.groovy in *groovy.postReceiveScripts* then email
  1071. # notifications for all repositories (regardless of access restrictions!)
  1072. # will be sent to these addresses.
  1073. #
  1074. # SPACE-DELIMITED
  1075. # SINCE 0.8.0
  1076. mail.mailingLists =
  1077. #
  1078. # Federation Settings
  1079. # SINCE 0.6.0
  1080. #
  1081. # A Gitblit federation is a way to backup one Gitblit instance to another.
  1082. #
  1083. # *git.enableGitServlet* must be true to use this feature.
  1084. # Your federation name is used for federation status acknowledgments. If it is
  1085. # unset, and you elect to send a status acknowledgment, your Gitblit instance
  1086. # will be identified by its hostname, if available, else your internal ip address.
  1087. # The source Gitblit instance will also append your external IP address to your
  1088. # identification to differentiate multiple pulling systems behind a single proxy.
  1089. #
  1090. # SINCE 0.6.0
  1091. federation.name =
  1092. # Specify the passphrase of this Gitblit instance.
  1093. #
  1094. # An unspecified (empty) passphrase disables processing federation requests.
  1095. #
  1096. # This value can be anything you want: an integer, a sentence, an haiku, etc.
  1097. # Keep the value simple, though, to avoid Java properties file encoding issues.
  1098. #
  1099. # Changing your passphrase will break any registrations you have established with other
  1100. # Gitblit instances.
  1101. #
  1102. # CASE-SENSITIVE
  1103. # SINCE 0.6.0
  1104. # RESTART REQUIRED *(only to enable or disable federation)*
  1105. federation.passphrase =
  1106. # Control whether or not this Gitblit instance can receive federation proposals
  1107. # from another Gitblit instance. Registering a federated Gitblit is a manual
  1108. # process. Proposals help to simplify that process by allowing a remote Gitblit
  1109. # instance to send your Gitblit instance the federation pull data.
  1110. #
  1111. # SINCE 0.6.0
  1112. federation.allowProposals = false
  1113. # The destination folder for cached federation proposals.
  1114. # Use forward slashes even on Windows!!
  1115. #
  1116. # SINCE 0.6.0
  1117. # BASEFOLDER
  1118. federation.proposalsFolder = ${baseFolder}/proposals
  1119. # The default pull frequency if frequency is unspecified on a registration
  1120. #
  1121. # SINCE 0.6.0
  1122. federation.defaultFrequency = 60 mins
  1123. # Federation Sets are named groups of repositories. The Federation Sets are
  1124. # available for selection in the repository settings page. You can assign a
  1125. # repository to one or more sets and then distribute the token for the set.
  1126. # This allows you to grant federation pull access to a subset of your available
  1127. # repositories. Tokens for federation sets only grant repository pull access.
  1128. #
  1129. # SPACE-DELIMITED
  1130. # CASE-SENSITIVE
  1131. # SINCE 0.6.0
  1132. federation.sets =
  1133. # Federation pull registrations
  1134. # Registrations are read once, at startup.
  1135. #
  1136. # RESTART REQUIRED
  1137. #
  1138. # frequency:
  1139. # The shortest frequency allowed is every 5 minutes
  1140. # Decimal frequency values are cast to integers
  1141. # Frequency values may be specified in mins, hours, or days
  1142. # Values that can not be parsed or are unspecified default to *federation.defaultFrequency*
  1143. #
  1144. # folder:
  1145. # if unspecified, the folder is *git.repositoriesFolder*
  1146. # if specified, the folder is relative to *git.repositoriesFolder*
  1147. #
  1148. # bare:
  1149. # if true, each repository will be created as a *bare* repository and will not
  1150. # have a working directory.
  1151. #
  1152. # if false, each repository will be created as a normal repository suitable
  1153. # for local work.
  1154. #
  1155. # mirror:
  1156. # if true, each repository HEAD is reset to *origin/master* after each pull.
  1157. # The repository will be flagged *isFrozen* after the initial clone.
  1158. #
  1159. # if false, each repository HEAD will point to the FETCH_HEAD of the initial
  1160. # clone from the origin until pushed to or otherwise manipulated.
  1161. #
  1162. # mergeAccounts:
  1163. # if true, remote accounts and their permissions are merged into your
  1164. # users.properties file
  1165. #
  1166. # notifyOnError:
  1167. # if true and the mail configuration is properly set, administrators will be
  1168. # notified by email of pull failures
  1169. #
  1170. # include and exclude:
  1171. # Space-delimited list of repositories to include or exclude from pull
  1172. # may be * wildcard to include or exclude all
  1173. # may use fuzzy match (e.g. org.eclipse.*)
  1174. #
  1175. # (Nearly) Perfect Mirror example
  1176. #
  1177. #federation.example1.url = https://go.gitblit.com
  1178. #federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4
  1179. #federation.example1.frequency = 120 mins
  1180. #federation.example1.folder =
  1181. #federation.example1.bare = true
  1182. #federation.example1.mirror = true
  1183. #federation.example1.mergeAccounts = true
  1184. #
  1185. # Advanced Realm Settings
  1186. #
  1187. # Auto-creates user accounts based on the servlet container principal. This
  1188. # assumes that your Gitblit install is a protected resource and your container's
  1189. # authentication process intercepts all Gitblit requests.
  1190. #
  1191. # SINCE 1.3.0
  1192. realm.container.autoCreateAccounts = false
  1193. # Allow or prohibit Windows guest account logins
  1194. #
  1195. # SINCE 1.3.0
  1196. realm.windows.allowGuests = false
  1197. # The default domain for authentication.
  1198. #
  1199. # If specified, this domain will be used for authentication UNLESS the supplied
  1200. # login name manually specifies a domain (.e.g. mydomain\james or james@mydomain)
  1201. #
  1202. # If unspecified, the username must be specified in UPN format (name@domain).
  1203. #
  1204. # if "." (dot) is specified, ONLY the local account database will be used.
  1205. #
  1206. # SINCE 1.3.0
  1207. realm.windows.defaultDomain =
  1208. # The PAM service name for authentication.
  1209. # default: system-auth
  1210. #
  1211. # SINCE 1.3.1
  1212. realm.pam.serviceName = system-auth
  1213. # The Apache htpasswd file that contains the users and passwords.
  1214. # default: ${baseFolder}/htpasswd
  1215. #
  1216. # RESTART REQUIRED
  1217. # BASEFOLDER
  1218. # SINCE 1.3.2
  1219. realm.htpasswd.userfile = ${baseFolder}/htpasswd
  1220. # Restrict the Salesforce user to members of this org.
  1221. # default: 0 (i.e. do not check the Org ID)
  1222. #
  1223. # SINCE 1.3.0
  1224. realm.salesforce.orgId = 0
  1225. # URL of the LDAP server.
  1226. # To use encrypted transport, use either ldaps:// URL for SSL or ldap+tls:// to
  1227. # send StartTLS command.
  1228. #
  1229. # SINCE 1.0.0
  1230. realm.ldap.server = ldap://localhost
  1231. # Login username for LDAP searches.
  1232. # If this value is unspecified, anonymous LDAP login will be used.
  1233. #
  1234. # e.g. mydomain\\username
  1235. #
  1236. # SINCE 1.0.0
  1237. realm.ldap.username = cn=Directory Manager
  1238. # Login password for LDAP searches.
  1239. #
  1240. # SINCE 1.0.0
  1241. realm.ldap.password = password
  1242. # Delegate team membership control to LDAP.
  1243. #
  1244. # If true, team user memberships will be specified by LDAP groups. This will
  1245. # disable team selection in Edit User and user selection in Edit Team.
  1246. #
  1247. # If false, LDAP will only be used for authentication and Gitblit will maintain
  1248. # team memberships with the *realm.ldap.backingUserService*.
  1249. #
  1250. # SINCE 1.0.0
  1251. realm.ldap.maintainTeams = false
  1252. # Root node for all LDAP users
  1253. #
  1254. # This is the root node from which subtree user searches will begin.
  1255. # If blank, Gitblit will search ALL nodes.
  1256. #
  1257. # SINCE 1.0.0
  1258. realm.ldap.accountBase = OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1259. # Filter criteria for LDAP users
  1260. #
  1261. # Query pattern to use when searching for a user account. This may be any valid
  1262. # LDAP query expression, including the standard (&) and (|) operators.
  1263. #
  1264. # Variables may be injected via the ${variableName} syntax.
  1265. # Recognized variables are:
  1266. # ${username} - The text entered as the user name
  1267. #
  1268. # SINCE 1.0.0
  1269. realm.ldap.accountPattern = (&(objectClass=person)(sAMAccountName=${username}))
  1270. # Root node for all LDAP groups to be used as Gitblit Teams
  1271. #
  1272. # This is the root node from which subtree team searches will begin.
  1273. # If blank, Gitblit will search ALL nodes.
  1274. #
  1275. # SINCE 1.0.0
  1276. realm.ldap.groupBase = OU=Groups,OU=UserControl,OU=MyOrganization,DC=MyDomain
  1277. # Filter criteria for LDAP groups
  1278. #
  1279. # Query pattern to use when searching for a team. This may be any valid
  1280. # LDAP query expression, including the standard (&) and (|) operators.
  1281. #
  1282. # Variables may be injected via the ${variableName} syntax.
  1283. # Recognized variables are:
  1284. # ${username} - The text entered as the user name
  1285. # ${dn} - The Distinguished Name of the user logged in
  1286. #
  1287. # All attributes from the LDAP User record are available. For example, if a user
  1288. # has an attribute "fullName" set to "John", "(fn=${fullName})" will be
  1289. # translated to "(fn=John)".
  1290. #
  1291. # SINCE 1.0.0
  1292. realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))
  1293. # Filter criteria for empty LDAP groups
  1294. #
  1295. # Query pattern to use when searching for an empty team. This may be any valid
  1296. # LDAP query expression, including the standard (&) and (|) operators.
  1297. #
  1298. # default: (&(objectClass=group)(!(member=*)))
  1299. # SINCE 1.4.0
  1300. realm.ldap.groupEmptyMemberPattern = (&(objectClass=group)(!(member=*)))
  1301. # LDAP users or groups that should be given administrator privileges.
  1302. #
  1303. # Teams are specified with a leading '@' character. Groups with spaces in the
  1304. # name can be entered as "@team name".
  1305. #
  1306. # e.g. realm.ldap.admins = john @git_admins "@git admins"
  1307. #
  1308. # SPACE-DELIMITED
  1309. # SINCE 1.0.0
  1310. realm.ldap.admins = @Git_Admins
  1311. # Attribute(s) on the USER record that indicate their display (or full) name.
  1312. # Leave blank for no mapping available in LDAP.
  1313. #
  1314. # This may be a single attribute, or a string of multiple attributes. Examples:
  1315. # displayName - Uses the attribute 'displayName' on the user record
  1316. # ${personalTitle}. ${givenName} ${surname} - Will concatenate the 3
  1317. # attributes together, with a '.' after personalTitle
  1318. #
  1319. # SINCE 1.0.0
  1320. realm.ldap.displayName = displayName
  1321. # Attribute(s) on the USER record that indicate their email address.
  1322. # Leave blank for no mapping available in LDAP.
  1323. #
  1324. # This may be a single attribute, or a string of multiple attributes. Examples:
  1325. # email - Uses the attribute 'email' on the user record
  1326. # ${givenName}.${surname}@gitblit.com -Will concatenate the 2 attributes
  1327. # together with a '.' and '@' creating something like first.last@gitblit.com
  1328. #
  1329. # SINCE 1.0.0
  1330. realm.ldap.email = email
  1331. # Attribute on the USER record that indicate their username to be used in gitblit
  1332. # when synchronizing users from LDAP
  1333. # if blank, Gitblit will use uid
  1334. # For MS Active Directory this may be sAMAccountName
  1335. #
  1336. # SINCE 1.0.0
  1337. realm.ldap.uid = uid
  1338. # Defines whether to synchronize all LDAP users and teams into the user service
  1339. #
  1340. # Valid values: true, false
  1341. # If left blank, false is assumed
  1342. #
  1343. # SINCE 1.4.0
  1344. realm.ldap.synchronize = false
  1345. # Defines the period to be used when synchronizing users and teams from ldap.
  1346. #
  1347. # Must be of the form '<long> <TimeUnit>' where <TimeUnit> is one of 'MILLISECONDS', 'SECONDS', 'MINUTES', 'HOURS', 'DAYS'
  1348. # default: 5 MINUTES
  1349. #
  1350. # RESTART REQUIRED
  1351. # SINCE 1.4.0
  1352. realm.ldap.syncPeriod = 5 MINUTES
  1353. # Defines whether to delete non-existent LDAP users from the user service
  1354. # during synchronization. depends on realm.ldap.synchronize = true
  1355. #
  1356. # Valid values: true, false
  1357. # If left blank, true is assumed
  1358. #
  1359. # SINCE 1.4.0
  1360. realm.ldap.removeDeletedUsers = true
  1361. # URL of the Redmine.
  1362. #
  1363. # SINCE 1.2.0
  1364. realm.redmine.url = http://example.com/redmine
  1365. #
  1366. # Server Settings
  1367. #
  1368. # The temporary folder to decompress the embedded gitblit webapp.
  1369. #
  1370. # SINCE 0.5.0
  1371. # RESTART REQUIRED
  1372. # BASEFOLDER
  1373. server.tempFolder = ${baseFolder}/temp
  1374. # Use Jetty NIO connectors. If false, Jetty Socket connectors will be used.
  1375. #
  1376. # SINCE 0.5.0
  1377. # RESTART REQUIRED
  1378. server.useNio = true
  1379. # Specify the maximum number of concurrent http/https worker threads to allow.
  1380. #
  1381. # SINCE 1.3.0
  1382. # RESTART REQUIRED
  1383. server.threadPoolSize = 50
  1384. # Context path for the GO application. You might want to change the context
  1385. # path if running Gitblit behind a proxy layer such as mod_proxy.
  1386. #
  1387. # SINCE 0.7.0
  1388. # RESTART REQUIRED
  1389. server.contextPath = /
  1390. # Standard http port to serve. <= 0 disables this connector.
  1391. # On Unix/Linux systems, ports < 1024 require root permissions.
  1392. # Recommended value: 80 or 8080
  1393. #
  1394. # SINCE 0.5.0
  1395. # RESTART REQUIRED
  1396. server.httpPort = 0
  1397. # Secure/SSL https port to serve. <= 0 disables this connector.
  1398. # On Unix/Linux systems, ports < 1024 require root permissions.
  1399. # Recommended value: 443 or 8443
  1400. #
  1401. # SINCE 0.5.0
  1402. # RESTART REQUIRED
  1403. server.httpsPort = 8443
  1404. # Port for serving an Apache JServ Protocol (AJP) 1.3 connector for integrating
  1405. # Gitblit GO into an Apache HTTP server setup. <= 0 disables this connector.
  1406. # Recommended value: 8009
  1407. #
  1408. # SINCE 0.9.0
  1409. # RESTART REQUIRED
  1410. server.ajpPort = 0
  1411. # Automatically redirect http requests to the secure https connector.
  1412. #
  1413. # This setting requires that you have configured server.httpPort and server.httpsPort.
  1414. # Unless you are on a private LAN where you trust all client connections, it is
  1415. # recommended to use https for all communications.
  1416. #
  1417. # SINCE 1.4.0
  1418. # RESTART REQUIRED
  1419. server.redirectToHttpsPort = false
  1420. # Specify the interface for Jetty to bind the standard connector.
  1421. # You may specify an ip or an empty value to bind to all interfaces.
  1422. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1423. # localhost.
  1424. #
  1425. # SINCE 0.5.0
  1426. # RESTART REQUIRED
  1427. server.httpBindInterface =
  1428. # Specify the interface for Jetty to bind the secure connector.
  1429. # You may specify an ip or an empty value to bind to all interfaces.
  1430. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1431. # localhost.
  1432. #
  1433. # SINCE 0.5.0
  1434. # RESTART REQUIRED
  1435. server.httpsBindInterface =
  1436. # Specify the interface for Jetty to bind the AJP connector.
  1437. # You may specify an ip or an empty value to bind to all interfaces.
  1438. # Specifying localhost will result in Gitblit ONLY listening to requests to
  1439. # localhost.
  1440. #
  1441. # SINCE 0.9.0
  1442. # RESTART REQUIRED
  1443. server.ajpBindInterface = localhost
  1444. # Alias of certificate to use for https/SSL serving. If blank the first
  1445. # certificate found in the keystore will be used.
  1446. #
  1447. # SINCE 1.2.0
  1448. # RESTART REQUIRED
  1449. server.certificateAlias = localhost
  1450. # Password for SSL keystore.
  1451. # Keystore password and certificate password must match.
  1452. # This is provided for convenience, its probably more secure to set this value
  1453. # using the --storePassword command line parameter.
  1454. #
  1455. # If you are using the official JRE or JDK from Oracle you may not have the
  1456. # JCE Unlimited Strength Jurisdiction Policy files bundled with your JVM. Because
  1457. # of this, your store/key password can not exceed 7 characters. If you require
  1458. # longer passwords you may need to install the JCE Unlimited Strength Jurisdiction
  1459. # Policy files from Oracle.
  1460. #
  1461. # http://www.oracle.com/technetwork/java/javase/downloads/index.html
  1462. #
  1463. # Gitblit and the Gitblit Certificate Authority will both indicate if Unlimited
  1464. # Strength encryption is available.
  1465. #
  1466. # SINCE 0.5.0
  1467. # RESTART REQUIRED
  1468. server.storePassword = gitblit
  1469. # If serving over https (recommended) you might consider requiring clients to
  1470. # authenticate with ssl certificates. If enabled, only https clients with the
  1471. # a valid client certificate will be able to access Gitblit.
  1472. #
  1473. # If disabled, client certificate authentication is optional and will be tried
  1474. # first before falling-back to form authentication or basic authentication.
  1475. #
  1476. # Requiring client certificates to access any of Gitblit may be too extreme,
  1477. # consider this carefully.
  1478. #
  1479. # SINCE 1.2.0
  1480. # RESTART REQUIRED
  1481. server.requireClientCertificates = false
  1482. # Port for shutdown monitor to listen on.
  1483. #
  1484. # SINCE 0.5.0
  1485. # RESTART REQUIRED
  1486. server.shutdownPort = 8081