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

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