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

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