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

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