Berke Viktor
2014-10-03 1bfe119cc7b46f80f4568e92b00893b98592753e
commit | author | age
0a98a6 1 #
SG 2 # Gitblit Settings
3 #
4
5 # This settings file supports parameterization from the command-line for the
6 # following command-line parameters:
7 #
8 #   --baseFolder    ${baseFolder}    SINCE 1.2.1
9 #
10 # Settings that support ${baseFolder} parameter substitution are indicated with the
11 # BASEFOLDER attribute.  If the --baseFolder argument is unspecified, ${baseFolder}
12 # and it's trailing / will be discarded from the setting value leaving a relative
13 # path that is equivalent to pre-1.2.1 releases.
14 #
15 # e.g. "${baseFolder}/git" becomes "git", if --baseFolder is unspecified 
16 #
17 # Git Servlet Settings
18 #
19
20 # Base folder for repositories.
21 # This folder may contain bare and non-bare repositories but Gitblit will only
22 # allow you to push to bare repositories.
23 # Use forward slashes even on Windows!!
24 # e.g. c:/gitrepos
25 #
26 # SINCE 0.5.0
27 # RESTART REQUIRED
28 # BASEFOLDER
29 git.repositoriesFolder = ${baseFolder}/git
30
31 # Build the available repository list at startup and cache this list for reuse.
32 # This reduces disk io when presenting the repositories page, responding to rpcs,
33 # etc, but it means that  Gitblit will not automatically identify repositories
34 # added or deleted by external tools.
35 #
36 # For this case you can use curl, wget, etc to issue an rpc request to clear the
37 # cache (e.g. https://localhost/rpc?req=CLEAR_REPOSITORY_CACHE)
38 #
39 # SINCE 1.1.0
40 git.cacheRepositoryList = true
41
42 # Search the repositories folder subfolders for other repositories.
43 # Repositories MAY NOT be nested (i.e. one repository within another)
44 # but they may be grouped together in subfolders.
45 # e.g. c:/gitrepos/libraries/mylibrary.git
46 #      c:/gitrepos/libraries/myotherlibrary.git
47 #
48 # SINCE 0.5.0
49 git.searchRepositoriesSubfolders = true
50
51 # Maximum number of folders to recurse into when searching for repositories.
52 # The default value, -1, disables depth limits.
53 #
54 # SINCE 1.1.0
55 git.searchRecursionDepth = -1
56
57 # List of regex exclusion patterns to match against folders found in
58 # *git.repositoriesFolder*.
59 # Use forward slashes even on Windows!!
60 # e.g. test/jgit\.git
61 #
62 # SPACE-DELIMITED
63 # CASE-SENSITIVE
64 # SINCE 1.1.0
65 git.searchExclusions =
66
67 # List of regex url patterns for extracting a repository name when locating
68 # submodules.
69 #   e.g. git.submoduleUrlPatterns = .*?://github.com/(.*) will extract
70 #   *gitblit/gitblit.git* from *git://github.com/gitblit/gitblit.git*
71 # If no matches are found then the submodule repository name is assumed to be
72 # whatever trails the last / character. (e.g. gitblit.git).
73 #
74 # SPACE-DELIMITED
75 # CASE-SENSITIVE
76 # SINCE 1.1.0
77 git.submoduleUrlPatterns = .*?://github.com/(.*)
78
79 # Specify the interface for Git Daemon to bind it's service.
80 # You may specify an ip or an empty value to bind to all interfaces.
81 # Specifying localhost will result in Gitblit ONLY listening to requests to
82 # localhost.
83 #
84 # SINCE 1.3.0
85 # RESTART REQUIRED
86 git.daemonBindInterface = 
87
88 # port for serving the Git Daemon service.  <= 0 disables this service.
89 # On Unix/Linux systems, ports < 1024 require root permissions.
90 # Recommended value: 9418
91 #
92 # SINCE 1.3.0
93 # RESTART REQUIRED
94 git.daemonPort = 9418
95
96 # The port for serving the SSH service.  <= 0 disables this service.
97 # On Unix/Linux systems, ports < 1024 require root permissions.
98 # Recommended value: 29418
99 #
100 # SINCE 1.5.0
101 # RESTART REQUIRED
102 git.sshPort = 29418
103
104 # Specify the interface for the SSH daemon to bind its service.
105 # You may specify an ip or an empty value to bind to all interfaces.
106 # Specifying localhost will result in Gitblit ONLY listening to requests to
107 # localhost.
108 #
109 # SINCE 1.5.0
110 # RESTART REQUIRED
111 git.sshBindInterface = 
112
113 # Specify the SSH key manager to use for retrieving, storing, and removing
114 # SSH keys.
115 #
116 # Valid key managers are:
117 #    com.gitblit.transport.ssh.FileKeyManager
118 #
119 # SINCE 1.5.0
120 git.sshKeysManager = com.gitblit.transport.ssh.FileKeyManager
121
122 # Directory for storing user SSH keys when using the FileKeyManager.
123 #
124 # SINCE 1.5.0
125 git.sshKeysFolder= ${baseFolder}/ssh
126
127 # SSH backend NIO2|MINA.
128 #
129 # The Apache Mina project recommends using the NIO2 backend.
130 #
131 # SINCE 1.5.0
132 git.sshBackend = NIO2
133
134 # Number of threads used to parse a command line submitted by a client over SSH
135 # for execution, create the internal data structures used by that command,
136 # and schedule it for execution on another thread.
137 #
138 # SINCE 1.5.0
139 git.sshCommandStartThreads = 2
140
141
142 # Allow push/pull over http/https with JGit servlet.
143 # If you do NOT want to allow Git clients to clone/push to Gitblit set this
144 # to false.  You might want to do this if you are only using ssh:// or git://.
145 # If you set this false, consider changing the *web.otherUrls* setting to
146 # indicate your clone/push urls.
147 #
148 # SINCE 0.5.0
149 git.enableGitServlet = true
150
151 # If you want to restrict all git servlet access to those with valid X509 client
152 # certificates then set this value to true.
153 #
154 # SINCE 1.2.0
155 git.requiresClientCertificate = false
156
157 # Enforce date checks on client certificates to ensure that they are not being
158 # used prematurely and that they have not expired.
159 #
160 # SINCE 1.2.0
161 git.enforceCertificateValidity = true
162
163 # List of OIDs to extract from a client certificate DN to map a certificate to
164 # an account username.
165 #
166 # e.g. git.certificateUsernameOIDs = CN
167 # e.g. git.certificateUsernameOIDs = FirstName LastName
168 #
169 # SPACE-DELIMITED
170 # SINCE 1.2.0
171 git.certificateUsernameOIDs = CN
172
173 # Only serve/display bare repositories.
174 # If there are non-bare repositories in git.repositoriesFolder and this setting
175 # is true, they will be excluded from the ui. 
176 #
177 # SINCE 0.9.0
178 git.onlyAccessBareRepositories = false
179
180
181 # Specify the list of acceptable transports for pushes.
182 # If this setting is empty, all transports are acceptable.
183 #
184 # Valid choices are: GIT HTTP HTTPS SSH
185 #
186 # SINCE 1.5.0
187 # SPACE-DELIMITED
188 git.acceptedPushTransports = HTTP HTTPS SSH
189
190 # Allow an authenticated user to create a destination repository on a push if
191 # the repository does not already exist.
192 #
193 # Administrator accounts can create a repository in any project.
194 # These repositories are created with the default access restriction and authorization
195 # control values.  The pushing account is set as the owner.
196 #
197 # Non-administrator accounts with the CREATE role may create personal repositories.
198 # These repositories are created as VIEW restricted for NAMED users.
199 # The pushing account is set as the owner.
200 #
201 # SINCE 1.2.0
202 git.allowCreateOnPush = true
203
204 # Global setting to control anonymous pushes.
205 #
206 # This setting allows/rejects anonymous pushes at the level of the receive pack.
207 # This trumps all repository config settings.  While anonymous pushes are convenient
208 # on your own box when you are a lone developer,  they are not recommended for
209 # any multi-user installation where accountability is required.  Since Gitblit
210 # tracks pushes and user accounts, allowing anonymous pushes compromises that
211 # information.
212 #
213 # SINCE 1.4.0
214 git.allowAnonymousPushes = false
215
216 # The default access restriction for new repositories.
217 # Valid values are NONE, PUSH, CLONE, VIEW
218 #  NONE = anonymous view, clone, & push
219 #  PUSH = anonymous view & clone and authenticated push
220 #  CLONE = anonymous view, authenticated clone & push
221 #  VIEW = authenticated view, clone, & push
222 #
223 # SINCE 1.0.0
224 git.defaultAccessRestriction = PUSH
225
226 # The default authorization control for new repositories.
227 # Valid values are AUTHENTICATED and NAMED
228 #  AUTHENTICATED = any authenticated user is granted restricted access
229 #  NAMED = only named users/teams are granted restricted access
230 #
231 # SINCE 1.1.0
232 git.defaultAuthorizationControl = NAMED
233
234 # The prefix for a users personal repository directory.
235 #
236 # Personal user repositories are created in this directory, named by the user name
237 # prefixed with the userRepositoryPrefix. For eaxmple, a user 'john' would have his
238 # personal repositories in the directory '~john'.
239 #
240 # Cannot be an empty string. Also, absolute paths are changed to relative paths by 
241 # removing the first directory separator.
242 #
243 # It is not recommended to change this value AFTER your user's have created
244 # personal repositories because it will break all permissions, ownership, and
245 # repository push/pull operations. 
246 #
247 # RESTART REQUIRED
248 # SINCE 1.4.0
249 git.userRepositoryPrefix = ~
250
251 # The default incremental push tag prefix.  Tag prefix applied to a repository
252 # that has automatic push tags enabled and does not specify a custom tag prefix.
253 #
254 # If incremental push tags are enabled, the tips of each branch in the push will
255 # be tagged with an increasing revision integer.
256 #
257 # e.g. refs/tags/r2345 or refs/tags/rev_2345 
258 #
259 # SINCE 1.3.0
260 git.defaultIncrementalPushTagPrefix = r
261
262 # Controls creating a repository as --shared on Unix servers.
263 #
264 # In an Unix environment where mixed access methods exist for shared repositories,
265 # the repository should be created with 'git init --shared' to make sure that
266 # it can be accessed e.g. via ssh (user git) and http (user www-data).
267 #
268 # Valid values are the values available for the '--shared' option. The the manual
269 # page for 'git init' for more information on shared repositories.
270 #
271 # SINCE 1.4.0
272 git.createRepositoriesShared = false
273
274 # Directory for gitignore templates used during repository creation.
275 #
276 # SINCE 1.6.0
277 git.gitignoreFolder = ${baseFolder}/gitignore
278
279 # Enable JGit-based garbage collection. (!!EXPERIMENTAL!!)
280 #
281 # USE AT YOUR OWN RISK!
282 #
283 # If enabled, the garbage collection executor scans all repositories once a day
284 # at the hour of your choosing.  The GC executor will take each repository "offline",
285 # one-at-a-time, to check if the repository satisfies it's GC trigger requirements.
286 #
287 # While the repository is offline it will be inaccessible from the web UI or from
288 # any of the other services (git, rpc, rss, etc).
289 #
290 # Gitblit's GC Executor MAY NOT PLAY NICE with the other Git kids on the block,
291 # especially on Windows systems, so if you are using other tools please coordinate
292 # their usage with your GC Executor schedule or do not use this feature.
293 #
294 # The GC algorithm complex and the JGit team advises caution when using their
295 # young implementation of GC.
296 #
297 # http://wiki.eclipse.org/EGit/New_and_Noteworthy/2.1#Garbage_Collector_and_Repository_Storage_Statistics
298 #
299 # EXPERIMENTAL
300 # SINCE 1.2.0
301 # RESTART REQUIRED
302 git.enableGarbageCollection = false
303
304 # Hour of the day for the GC Executor to scan repositories.
305 # This value is in 24-hour time.
306 #
307 # SINCE 1.2.0
308 git.garbageCollectionHour = 0
309
310 # The default minimum total filesize of loose objects to trigger early garbage
311 # collection.
312 #
313 # You may specify a custom threshold for a repository in the repository's settings.
314 # Common unit suffixes of k, m, or g are supported.
315 #
316 # SINCE 1.2.0
317 git.defaultGarbageCollectionThreshold = 500k
318
319 # The default period, in days, between GCs for a repository.  If the total filesize
320 # of the loose object exceeds *git.garbageCollectionThreshold* or the repository's
321 # custom threshold, this period will be short-circuited. 
322 #
323 # e.g. if a repository collects 100KB of loose objects every day with a 500KB
324 # threshold and a period of 7 days, it will take 5 days for the loose objects to
325 # be collected, packed, and pruned.
326 #
327 # OR
328 #
329 # if a repository collects 10KB of loose objects every day with a 500KB threshold
330 # and a period of 7 days, it will take the full 7 days for the loose objects to be
331 # collected, packed, and pruned.
332 #
333 # You may specify a custom period for a repository in the repository's settings.
334 #
335 # The minimum value is 1 day since the GC Executor only runs once a day.
336 #
337 # SINCE 1.2.0
338 git.defaultGarbageCollectionPeriod = 7
339
340 # Gitblit can automatically fetch ref updates for a properly configured mirror
341 # repository.
342 #
343 # Requirements:
344 # 1. you must manually clone the repository using native git
345 #    git clone --mirror git://somewhere.com/myrepo.git
346 # 2. the "origin" remote must be the mirror source
347 # 3. the "origin" repository must be accessible without authentication OR the
348 #    credentials must be embedded in the origin url (not recommended)
349 #
350 # Notes:
351 # 1. "origin" SSH urls are untested and not likely to work
352 # 2. mirrors cloned while Gitblit is running are likely to require clearing the
353 #    gitblit cache (link on the repositories page of an administrator account)
354 # 3. Gitblit will automatically repair any invalid fetch refspecs with a "//"
355 #    sequence.
356 #
357 # SINCE 1.4.0
358 # RESTART REQUIRED
359 git.enableMirroring = false
360
361 # Specify the period between update checks for mirrored repositories.
362 # The shortest period you may specify between mirror update checks is 5 mins.
363 #
364 # SINCE 1.4.0
365 # RESTART REQUIRED
366 git.mirrorPeriod = 30 mins
367
368 # Number of bytes of a pack file to load into memory in a single read operation.
369 # This is the "page size" of the JGit buffer cache, used for all pack access
370 # operations. All disk IO occurs as single window reads. Setting this too large
371 # may cause the process to load more data than is required; setting this too small
372 # may increase the frequency of read() system calls.
373 #
374 # Default on JGit is 8 KiB on all platforms.
375 #
376 # Common unit suffixes of k, m, or g are supported.
377 # Documentation courtesy of the Gerrit project.
378 #
379 # SINCE 1.0.0
380 # RESTART REQUIRED
381 git.packedGitWindowSize = 8k
382
383 # Maximum number of bytes to load and cache in memory from pack files. If JGit
384 # needs to access more than this many bytes it will unload less frequently used
385 # windows to reclaim memory space within the process. As this buffer must be shared
386 # with the rest of the JVM heap, it should be a fraction of the total memory available.
387 #
388 # The JGit team recommends setting this value larger than the size of your biggest
389 # repository. This ensures you can serve most requests from memory.
390 #
391 # Default on JGit is 10 MiB on all platforms.
392 #
393 # Common unit suffixes of k, m, or g are supported.
394 # Documentation courtesy of the Gerrit project.
395 #
396 # SINCE 1.0.0
397 # RESTART REQUIRED
398 git.packedGitLimit = 10m
399
400 # Maximum number of bytes to reserve for caching base objects that multiple deltafied
401 # objects reference. By storing the entire decompressed base object in a cache Git
402 # is able to avoid unpacking and decompressing frequently used base objects multiple times.
403 #
404 # Default on JGit is 10 MiB on all platforms. You probably do not need to adjust
405 # this value.
406 #
407 # Common unit suffixes of k, m, or g are supported.
408 # Documentation courtesy of the Gerrit project.
409 #
410 # SINCE 1.0.0
411 # RESTART REQUIRED
412 git.deltaBaseCacheLimit = 10m
413
414 # Maximum number of pack files to have open at once. A pack file must be opened
415 # in order for any of its data to be available in a cached window.
416 #
417 # If you increase this to a larger setting you may need to also adjust the ulimit
418 # on file descriptors for the host JVM, as Gitblit needs additional file descriptors
419 # available for network sockets and other repository data manipulation.
420 #
421 # Default on JGit is 128 file descriptors on all platforms.
422 # Documentation courtesy of the Gerrit project.
423 #
424 # SINCE 1.0.0
425 # RESTART REQUIRED
426 git.packedGitOpenFiles = 128
427
428 # When true, JGit will use mmap() rather than malloc()+read() to load data from
429 # pack files.  The use of mmap can be problematic on some JVMs as the garbage
430 # collector must deduce that a memory mapped segment is no longer in use before
431 # a call to munmap() can be made by the JVM native code.
432 #
433 # In server applications (such as Gitblit) that need to access many pack files,
434 # setting this to true risks artificially running out of virtual address space, 
435 # as the garbage collector cannot reclaim unused mapped spaces fast enough.
436 #
437 # Default on JGit is false. Although potentially slower, it yields much more
438 # predictable behavior.
439 # Documentation courtesy of the Gerrit project.
440 #
441 # SINCE 1.0.0
442 # RESTART REQUIRED
443 git.packedGitMmap = false
444
445 # Validate all received (pushed) objects are valid.
446 #
447 # SINCE 1.5.0
448 git.checkReceivedObjects = true
449
450 # Validate all referenced but not supplied objects are reachable.
451 #
452 # If enabled, Gitblit will verify that references to objects not contained
453 # within the received pack are already reachable through at least one other
454 # reference advertised to clients.
455 #
456 # This feature is useful when Gitblit doesn't trust the client to not provide a
457 # forged SHA-1 reference to an object, in an attempt to access parts of the DAG
458 # that they aren't allowed to see and which have been hidden from them via the
459 # configured AdvertiseRefsHook or RefFilter.
460 #
461 # Enabling this feature may imply at least some, if not all, of the same functionality
462 # performed by git.checkReceivedObjects. 
463 #
464 # SINCE 1.5.0
465 git.checkReferencedObjectsAreReachable = true
466
467 # Set the maximum allowed Git object size.
468 #
469 # If an object is larger than the given size the pack-parsing will throw an exception
470 # aborting the receive-pack operation.  The default value, 0, disables maximum
471 # object size checking.
472 #
473 # SINCE 1.5.0
474 git.maxObjectSizeLimit = 0
475
476 # Set the maximum allowed pack size.
477 #
478 # A pack exceeding this size will be rejected. The default value, -1, disables
479 # maximum pack size checking.
480 #
481 # SINCE 1.5.0
482 git.maxPackSizeLimit = -1
483
484 # Use the Gitblit patch receive pack for processing contributions and tickets.
485 # This allows the user to push a patch using the familiar Gerrit syntax:
486 #
487 #    git push <remote> HEAD:refs/for/<targetBranch>
488 #
489 # NOTE:
490 # This requires git.enableGitServlet = true AND it requires an authenticated
491 # git transport connection (http/https) when pushing from a client.
492 #
493 # Valid services include:
494 #    com.gitblit.tickets.FileTicketService
495 #    com.gitblit.tickets.BranchTicketService
496 #    com.gitblit.tickets.RedisTicketService
497 #
498 # SINCE 1.4.0
499 # RESTART REQUIRED
500 tickets.service = 
501
502 # Globally enable or disable creation of new bug, enhancement, task, etc tickets
503 # for all repositories.
504 #
505 # If false, no tickets can be created through the ui for any repositories.
506 # If true, each repository can control if they allow new tickets to be created.
507 #
508 # NOTE:
509 # If a repository is accepting patchsets, new proposal tickets can be created
510 # regardless of this setting.
511 #
512 # SINCE 1.4.0
513 tickets.acceptNewTickets = true
514
515 # Globally enable or disable pushing patchsets to all repositories.
516 #
517 # If false, no patchsets will be accepted for any repositories.
518 # If true, each repository can control if they accept new patchsets.
519 #
520 # NOTE:
521 # If a repository is accepting patchsets, new proposal tickets can be created
522 # regardless of the acceptNewTickets setting.
523 #
524 # SINCE 1.4.0
525 tickets.acceptNewPatchsets = true
526
527 # Default setting to control patchset merge through the web ui.  If true, patchsets
528 # must have an approval score to enable the merge button.  This setting can be
529 # overriden per-repository.
530 #
531 # SINCE 1.4.0
532 tickets.requireApproval = false
533
534 # The case-insensitive regular expression used to identify and close tickets on
535 # push to the integration branch for commits that are NOT already referenced as
536 # a patchset tip.
537 #
538 # SINCE 1.5.0
539 tickets.closeOnPushCommitMessageRegex = (?:fixes|closes)[\\s-]+#?(\\d+)
540
541 # Specify the location of the Lucene Ticket index
542 #
543 # SINCE 1.4.0
544 # RESTART REQUIRED
545 tickets.indexFolder = ${baseFolder}/tickets/lucene
546
547 # Define the url for the Redis server.
548 #
549 # e.g. redis://localhost:6379
550 #      redis://:foobared@localhost:6379/2
551 #
552 # SINCE 1.4.0
553 # RESTART REQUIRED
554 tickets.redis.url =
555
556 # The number of tickets to display on a page.
557 #
558 # SINCE 1.4.0
559 tickets.perPage = 25
560
561 # The folder where plugins are loaded from.
562 #
563 # SINCE 1.5.0
564 # RESTART REQUIRED
565 # BASEFOLDER
566 plugins.folder = ${baseFolder}/plugins
567
568 # The registry of available plugins.
569 #
570 # SINCE 1.5.0
571 plugins.registry = http://plugins.gitblit.com/plugins.json
572
573 # Number of threads used to handle miscellaneous tasks in the background.
574 #
575 # SINCE 1.6.0
576 # RESTART REQUIRED
577 execution.defaultThreadPoolSize = 1
578
579 #
580 # Groovy Integration
581 #
582
583 # Location of Groovy scripts to use for Pre and Post receive hooks.
584 # Use forward slashes even on Windows!!
585 # e.g. c:/groovy
586 #
587 # RESTART REQUIRED
588 # SINCE 0.8.0
589 # BASEFOLDER
590 groovy.scriptsFolder = ${baseFolder}/groovy
591
592 # Specify the directory Grape uses for downloading libraries.
593 # http://groovy.codehaus.org/Grape
594 #
595 # RESTART REQUIRED
596 # SINCE 1.0.0
597 # BASEFOLDER
598 groovy.grapeFolder = ${baseFolder}/groovy/grape
599
600 # Scripts to execute on Pre-Receive.
601 #
602 # These scripts execute after an incoming push has been parsed and validated
603 # but BEFORE the changes are applied to the repository.  You might reject a
604 # push in this script based on the repository and branch the push is attempting
605 # to change.
606 #
607 # Script names are case-sensitive on case-sensitive file systems.  You may omit
608 # the traditional ".groovy" from this list if your file extension is ".groovy" 
609 #
610 # NOTE:
611 # These scripts are only executed when pushing to *Gitblit*, not to other Git
612 # tooling you may be using.  Also note that these scripts are shared between
613 # repositories. These are NOT repository-specific scripts!  Within the script
614 # you may customize the control-flow for a specific repository by checking the
615 # *repository* variable.
616 #
617 # SPACE-DELIMITED
618 # CASE-SENSITIVE
619 # SINCE 0.8.0
620 groovy.preReceiveScripts =
621
622 # Scripts to execute on Post-Receive.
623 #
624 # These scripts execute AFTER an incoming push has been applied to a repository.
625 # You might trigger a continuous-integration build here or send a notification.
626 #
627 # Script names are case-sensitive on case-sensitive file systems.  You may omit
628 # the traditional ".groovy" from this list if your file extension is ".groovy" 
629 #
630 # NOTE:
631 # These scripts are only executed when pushing to *Gitblit*, not to other Git
632 # tooling you may be using.  Also note that these scripts are shared between
633 # repositories. These are NOT repository-specific scripts!  Within the script
634 # you may customize the control-flow for a specific repository by checking the
635 # *repository* variable.
636
637 # SPACE-DELIMITED
638 # CASE-SENSITIVE
639 # SINCE 0.8.0
640 groovy.postReceiveScripts =
641
642 # Repository custom fields for Groovy Hook mechanism
643 #
644 # List of key=label pairs of custom fields to prompt for in the Edit Repository
645 # page.  These keys are stored in the repository's git config file in the 
646 # section [gitblit "customFields"].  Key names are alphanumeric only.  These
647 # fields are intended to be used for the Groovy hook mechanism where a script
648 # can adjust it's execution based on the custom fields stored in the repository
649 # config.
650 #
651 # e.g. "commitMsgRegex=Commit Message Regular Expression" anotherProperty=Another
652 #
653 # SPACE-DELIMITED
654 # SINCE 1.0.0
655 groovy.customFields = 
656
657 #
658 # Fanout Settings
659 #
660
661 # Fanout is a PubSub notification service that can be used by Sparkleshare
662 # to eliminate repository change polling.  The fanout service runs in a separate
663 # thread on a separate port from the Gitblit http/https application.
664 # This service is provided so that Sparkleshare may be used with Gitblit in
665 # firewalled environments or where reliance on Sparkleshare's default notifications
666 # server (notifications.sparkleshare.org) is unwanted.
667 #
668 # This service maintains an open socket connection from the client to the
669 # Fanout PubSub service. This service may not work properly behind a proxy server.  
670
671 # Specify the interface for Fanout to bind it's service.
672 # You may specify an ip or an empty value to bind to all interfaces.
673 # Specifying localhost will result in Gitblit ONLY listening to requests to
674 # localhost.
675 #
676 # SINCE 1.2.1
677 # RESTART REQUIRED
678 fanout.bindInterface = 
679
680 # port for serving the Fanout PubSub service.  <= 0 disables this service.
681 # On Unix/Linux systems, ports < 1024 require root permissions.
682 # Recommended value: 17000
683 #
684 # SINCE 1.2.1
685 # RESTART REQUIRED
686 fanout.port = 0
687
688 # Use Fanout NIO service.  If false, a multi-threaded socket service will be used.
689 # Be advised, the socket implementation spawns a thread per connection plus the
690 # connection acceptor thread.  The NIO implementation is completely single-threaded.
691 #
692 # SINCE 1.2.1
693 # RESTART REQUIRED
694 fanout.useNio = true
695
696 # Concurrent connection limit.  <= 0 disables concurrent connection throttling.
697 # If > 0, only the specified number of concurrent connections will be allowed
698 # and all other connections will be rejected.
699 #
700 # SINCE 1.2.1
701 # RESTART REQUIRED
702 fanout.connectionLimit = 0
703
704 #
705 # Authentication Settings
706 #
707
708 # Require authentication to see everything but the admin pages
709 #
710 # SINCE 0.5.0
711 # RESTART REQUIRED
712 web.authenticateViewPages = false
713
714 # If web.authenticateViewPages=true you may optionally require a client-side
715 # basic authentication prompt instead of the standard form-based login. 
716 #
717 # SINCE 1.3.0
718 web.enforceHttpBasicAuthentication = false
719
720 # Require admin authentication for the admin functions and pages
721 #
722 # SINCE 0.5.0
723 # RESTART REQUIRED
724 web.authenticateAdminPages = true
725
726 # Allow Gitblit to store a cookie in the user's browser for automatic
727 # authentication.  The cookie is generated by the user service.
728 #
729 # SINCE 0.5.0
730 web.allowCookieAuthentication = true
731
732 # Allow deletion of non-empty repositories. This is enforced for all delete vectors.
733 #
734 # SINCE 1.6.0
735 web.allowDeletingNonEmptyRepositories = true
736
737 # Setting to include personal repositories in the main repositories list.
738 #
739 # SINCE 1.6.0
740 web.includePersonalRepositories = false
741
742 # Config file for storing project metadata
743 #
744 # SINCE 1.2.0
745 # BASEFOLDER
746 web.projectsFile = ${baseFolder}/projects.conf
747
748 # Either the full path to a user config file (users.conf)
749 # OR a fully qualified class name that implements the IUserService interface.
750 #
751 # Any custom user service implementation must have a public default constructor.
752 #
753 # SINCE 0.5.0
754 # RESTART REQUIRED
755 # BASEFOLDER
756 realm.userService = ${baseFolder}/users.conf
757
758 # Ordered list of external authentication providers which will be used if
759 # authentication against the local user service fails.
760 #
761 # Valid providers are:
762 #
763 #    htpasswd
764 #    ldap
765 #    pam
766 #    redmine
767 #    salesforce
768 #    windows
769
770 # e.g. realm.authenticationProviders = htpasswd windows
771 #
772 # SINCE 1.4.0
773 # RESTART REQUIRED
774 # SPACE-DELIMITED
775 realm.authenticationProviders =
776
777 # How to store passwords.
778 # Valid values are plain, md5, or combined-md5.  md5 is the hash of password.
779 # combined-md5 is the hash of username.toLowerCase()+password.
780 # Default is md5.
781 #
782 # SINCE 0.5.0 
783 realm.passwordStorage = md5
784
785 # Minimum valid length for a plain text password.
786 # Default value is 5.  Absolute minimum is 4.
787 #
788 # SINCE 0.5.0 
789 realm.minPasswordLength = 5
790
791 #
792 # Gitblit Web Settings
793 #
794 # If blank Gitblit is displayed.
795 #
796 # SINCE 0.5.0
797 web.siteName =
798
799 # The canonical url of your Gitblit server to be used in repository url generation,
800 # RSS feeds, and all embedded links in email and plugin-based notifications.
801 #
802 # If you are running Gitblit on a non-standard http port (i.e. not 80 and not 443)
803 # then you must specify that port in this url otherwise your generated urls will be
804 # incorrect.
805 #
806 # The hostname of this url will be extracted for SSH and GIT protocol repository
807 # url generation.
808 #
809 # e.g. web.canonicalUrl = https://dev.gitblit.com
810 #      web.canonicalUrl = https://dev.gitblit.com:8443
811 #
812 # SINCE 1.4.0
813 web.canonicalUrl = 
814
815 # You may specify a different logo image for the header but it must be 120x45px.
816 # If the specified file does not exist, the default Gitblit logo will be used.
817 #
818 # SINCE 1.3.0
819 # BASEFOLDER
820 web.headerLogo = ${baseFolder}/logo.png
821
822 # You may specify a different link URL for the logo image anchor.
823 # If blank the Gitblit main page URL is used.
824 #
825 # SINCE 1.3.0
826 # BASEFOLDER
827 web.rootLink =
828
829 # You may specify a custom header background CSS color.  If unspecified, the
830 # default color will be used.
831 #
832 # e.g. web.headerBackgroundColor = #002060
833 #
834 # SINCE 1.3.0
835 web.headerBackgroundColor =
836
837 # You may specify a custom header foreground CSS color.  If unspecified, the
838 # default color will be used.
839 #
840 # e.g. web.headerForegroundColor = white
841 #
842 # SINCE 1.3.0
843 web.headerForegroundColor =
844
845 # You may specify a custom header foreground hover CSS color.  If unspecified, the
846 # default color will be used.
847 #
848 # e.g. web.headerHoverColor = white
849 #
850 # SINCE 1.3.0
851 web.headerHoverColor =
852
853 # You may specify a custom header border CSS color.  If unspecified, the default
854 # color will be used.
855 #
856 # e.g. web.headerBorderColor = #002060
857 #
858 # SINCE 1.3.0
859 web.headerBorderColor =
860
861 # You may specify a custom header border CSS color.  If unspecified, the default
862 # color will be used.
863 #
864 # e.g. web.headerBorderFocusColor = #ff9900
865 #
866 # SINCE 1.3.0
867 web.headerBorderFocusColor =
868
869 # If *web.authenticateAdminPages*=true, users with "admin" role can create
870 # repositories, create users, and edit repository metadata.
871 #
872 # If *web.authenticateAdminPages*=false, any user can execute the aforementioned
873 # functions. 
874 #
875 # SINCE 0.5.0 
876 web.allowAdministration = true
877
878 # Setting to disable rendering the top-level navigation header which includes
879 # the login form, top-level links like dashboard, repositories, search, etc.
880 # This setting is only useful if you plan to embed Gitblit within another page
881 # or system.
882 #
883 # SINCE 1.4.0
884 web.hideHeader = false
885
886 # Allows rpc clients to list repositories and possibly manage or administer the 
887 # Gitblit server, if the authenticated account has administrator permissions.
888 # See *web.enableRpcManagement* and *web.enableRpcAdministration*.
889 #
890 # SINCE 0.7.0 
891 web.enableRpcServlet = true
892
893 # Allows rpc clients to manage repositories and users of the Gitblit instance,
894 # if the authenticated account has administrator permissions.
895 # Requires *web.enableRpcServlet=true*.
896 #
897 # SINCE 0.7.0 
898 web.enableRpcManagement = false
899
900 # Allows rpc clients to control the server settings and monitor the health of this
901 # this Gitblit instance, if the authenticated account has administrator permissions.
902 # Requires *web.enableRpcServlet=true* and *web.enableRpcManagement*.
903 #
904 # SINCE 0.7.0 
905 web.enableRpcAdministration = false
906
907 # Full path to a configurable robots.txt file.  With this file you can control
908 # what parts of your Gitblit server respectable robots are allowed to traverse.
909 # http://googlewebmastercentral.blogspot.com/2008/06/improving-on-robots-exclusion-protocol.html
910 #
911 # SINCE 1.0.0
912 # BASEFOLDER
913 web.robots.txt = ${baseFolder}/robots.txt
914
915 # The number of minutes to cache a page in the browser since the last request.
916 # The default value is 0 minutes.  A value <= 0 disables all page caching which
917 # is the default behavior for Gitblit <= 1.3.0.
918 #
919 # SINCE 1.3.1
920 web.pageCacheExpires = 0
921
922 # If true, the web ui layout will respond and adapt to the browser's dimensions.
923 # if false, the web ui will use a 940px fixed-width layout.
924 # http://twitter.github.com/bootstrap/scaffolding.html#responsive
925 #
926 # SINCE 1.0.0
927 web.useResponsiveLayout = true
928
929 # Allow Gravatar images to be displayed in Gitblit pages.
930 #
931 # SINCE 0.8.0
932 web.allowGravatar = true
933
934 # Allow dynamic zip downloads.
935 #
936 # SINCE 0.5.0   
937 web.allowZipDownloads = true
938
939 # If *web.allowZipDownloads=true* the following formats will be displayed for
940 # download compressed archive links:
941 #
942 # zip   = standard .zip
943 # tar   = standard tar format (preserves *nix permissions and symlinks)
944 # gz    = gz-compressed tar
945 # xz    = xz-compressed tar
946 # bzip2 = bzip2-compressed tar
947 #
948 # SPACE-DELIMITED
949 # SINCE 1.2.0
950 web.compressedDownloads = zip gz
951
952 # Allow optional Lucene integration. Lucene indexing is an opt-in feature.
953 # A repository may specify branches to index with Lucene instead of using Git
954 # commit traversal. There are scenarios where you may want to completely disable
955 # Lucene indexing despite a repository specifying indexed branches.  One such
956 # scenario is on a resource-constrained federated Gitblit mirror.
957 #
958 # SINCE 0.9.0
959 web.allowLuceneIndexing = true
960
936af6 961 # Control the frequency of Lucene repository indexing.
JM 962 # The default setting is to check for updated refs every 2 mins.
963 #
964 # SINCE 1.6.1
965 web.luceneFrequency = 2 mins
966
0a98a6 967 # Allows an authenticated user to create forks of a repository
SG 968 #
969 # set this to false if you want to disable all fork controls on the web site
970 #
971 web.allowForking = true
972
973 # Controls the length of shortened commit hash ids
974 #
975 # SINCE 1.2.0
976 web.shortCommitIdLength = 6
977
978 # Use Clippy (Flash solution) to provide a copy-to-clipboard button.
979 # If false, a button with a more primitive JavaScript-based prompt box will
980 # offer a 3-step (click, ctrl+c, enter) copy-to-clipboard alternative.
981 #
982 # SINCE 0.8.0
983 web.allowFlashCopyToClipboard = true
984
985 # Default maximum number of commits that a repository may contribute to the
986 # activity page, regardless of the selected duration.  This setting may be valuable
987 # for an extremely busy server.  This value may also be configed per-repository
988 # in Edit Repository. 0 disables this throttle.
989 #
990 # SINCE 1.2.0
991 web.maxActivityCommits = 0
992
993 # Default number of entries to include in RSS Syndication links
994 #
995 # SINCE 0.5.0
996 web.syndicationEntries = 25
997
998 # Show the size of each repository on the repositories page.
999 # This requires recursive traversal of each repository folder.  This may be
1000 # non-performant on some operating systems and/or filesystems. 
1001 #
1002 # SINCE 0.5.2
1003 web.showRepositorySizes = true
1004
1005 # List of custom regex expressions that can be displayed in the Filters menu
1006 # of the Repositories and Activity pages.  Keep them very simple because you
1007 # are likely to run into encoding issues if they are too complex.
1008 #
1009 # Use !!! to separate the filters 
1010 #
1011 # SINCE 0.8.0
1012 web.customFilters =
1013
1014 # Show federation registrations (without token) and the current pull status
1015 # to non-administrator users. 
1016 #
1017 # SINCE 0.6.0
1018 web.showFederationRegistrations = false
1019
1020 # This is the message displayed when *web.authenticateViewPages=true*.
1021 # This can point to a file with Markdown content.
1022 # Specifying "gitblit" uses the internal login message.
1023 #
1024 # SINCE 0.7.0
1025 # BASEFOLDER
1026 web.loginMessage = gitblit
1027
1028 # This is the message displayed above the repositories table.
1029 # This can point to a file with Markdown content.
1030 # Specifying "gitblit" uses the internal welcome message.
1031 #
1032 # SINCE 0.5.0
1033 # BASEFOLDER
1034 web.repositoriesMessage = gitblit
1035
1036 # Ordered list of charsets/encodings to use when trying to display a blob.
1037 # If empty, UTF-8 and ISO-8859-1 are used.  The server's default charset
1038 # is always appended to the encoding list.  If all encodings fail to cleanly
1039 # decode the blob content, UTF-8 will be used with the standard malformed
1040 # input/unmappable character replacement strings.
1041
1042 # SPACE-DELIMITED
1043 # SINCE 1.0.0
1044 web.blobEncodings = UTF-8 ISO-8859-1
1045
1046 # Manually set the default timezone to be used by Gitblit for display in the 
1047 # web ui.  This value is independent of the JVM timezone.  Specifying a blank
1048 # value will default to the JVM timezone.
1049 # e.g. America/New_York, US/Pacific, UTC, Europe/Berlin
1050 #
1051 # SINCE 0.9.0
1052 # RESTART REQUIRED
1053 web.timezone =
1054
1055 # Use the client timezone when formatting dates.
1056 # This uses AJAX to determine the browser's timezone and may require more
1057 # server overhead because a Wicket session is created.  All Gitblit pages
1058 # attempt to be stateless, if possible.
1059 #
1060 # SINCE 0.5.0
1061 # RESTART REQUIRED
1062 web.useClientTimezone = false
1063
1064 # Time format
1065 # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
1066 #
1067 # SINCE 0.8.0
1068 web.timeFormat = HH:mm
1069
1070 # Short date format
1071 # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
1072 #
1073 # SINCE 0.5.0
1074 web.datestampShortFormat = yyyy-MM-dd
1075
1076 # Long date format
1077 #
1078 # SINCE 0.8.0
1079 web.datestampLongFormat = EEEE, MMMM d, yyyy
1080
1081 # Long timestamp format
1082 # <http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html>
1083 #
1084 # SINCE 0.5.0
1085 web.datetimestampLongFormat = EEEE, MMMM d, yyyy HH:mm Z
1086
1087 # Mount URL parameters
1088 # This setting controls if pretty or parameter URLs are used.
1089 # i.e.
1090 # if true:
1091 #     http://localhost/commit/myrepo/abcdef
1092 # if false:
1093 #     http://localhost/commit/?r=myrepo&h=abcdef
1094 #
1095 # SINCE 0.5.0
1096 # RESTART REQUIRED
1097 web.mountParameters = true
1098
1099 # Some servlet containers (e.g. Tomcat >= 6.0.10) disallow '/' (%2F) encoding
1100 # in URLs as a security precaution for proxies.  This setting tells Gitblit
1101 # to preemptively replace '/' with '*' or '!' for url string parameters.
1102 #
1103 # <https://issues.apache.org/jira/browse/WICKET-1303>
1104 # <http://tomcat.apache.org/security-6.html#Fixed_in_Apache_Tomcat_6.0.10>
1105 # Add *-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true* to your
1106 # *CATALINA_OPTS* or to your JVM launch parameters
1107 #
1108 # SINCE 0.5.2
1109 web.forwardSlashCharacter = /
1110
1111 # Show other URLs on the summary page for accessing your git repositories
1112 # Use spaces to separate urls.
1113 #
1114 # {0} is the token for the repository name
1115 # {1} is the token for the username
1116 #
1117 # The username is only practical if you have setup your other git serving
1118 # solutions accounts to have the same username as the Gitblit account.
1119 #
1120 # e.g.
1121 # web.otherUrls = ssh://localhost/git/{0} git://localhost/git/{0} https://{1}@localhost/r/{0}
1122 #
1123 # SPACE-DELIMITED
1124 # SINCE 0.5.0
1125 web.otherUrls = 
1126
1127 # Should app-specific clone links be displayed for SourceTree, SparkleShare, etc?
1128 #
1129 # SINCE 1.3.0
1130 web.allowAppCloneLinks = true
1131
1132 # Choose how to present the repositories list.
1133 #   grouped = group nested/subfolder repositories together (no sorting)
1134 #   flat = flat list of repositories (sorting allowed)
1135 #
1136 # SINCE 0.5.0
1137 web.repositoryListType = grouped
1138
1139 # If using a grouped repository list and there are repositories at the
1140 # root level of your repositories folder, you may specify the displayed
1141 # group name with this setting.  This value is only used for web presentation.
1142 #
1143 # SINCE 0.5.0
1144 web.repositoryRootGroupName = main
1145
1146 # Display the repository swatch color next to the repository name link in the 
1147 # repositories list. 
1148 #
1149 # SINCE 0.8.0
1150 web.repositoryListSwatches = true
1151
1152 # Defines the default commit message renderer.  This can be configured
1153 # per-repository.
1154 #
1155 # Valid values are: plain, markdown
1156 #
1157 # SINCE 1.4.0
1158 web.commitMessageRenderer = plain
1159
1160 # Control if email addresses are shown in web ui
1161 #
1162 # SINCE 0.5.0
1163 web.showEmailAddresses = true
1164
1165 # Shows a combobox in the page links header with commit, committer, and author
1166 # search selection.  Default search is commit.
1167 #
1168 # SINCE 0.5.0
1169 web.showSearchTypeSelection = false
1170
1171 # Controls display of activity graphs on the dashboard, activity, and summary
1172 # pages.  Charting makes use of the external Google Charts API.
1173 #
1174 # SINCE 0.5.0 
1175 web.generateActivityGraph = true
1176
1177 # Displays the commits branch graph in the summary page and commits/log page.
1178 #
1179 # SINCE 1.4.0
1180 web.showBranchGraph = true
1181
1182 # The default number of days to show on the activity page.
1183 # Value must exceed 0 else default of 7 is used
1184 #
1185 # SINCE 0.8.0
1186 web.activityDuration = 7
1187
1188 # Choices for days of activity to display.
1189 #
1190 # SPACE-DELIMITED
1191 # SINCE 1.3.0
1192 web.activityDurationChoices = 1 3 7 14 21 28
1193
1194 # Maximum number of days of activity that may be displayed on the activity page.
1195 #
1196 # SINCE 1.3.2
1197 web.activityDurationMaximum = 30
1198
1199 # The number of days of commits to cache in memory for the dashboard, activity,
1200 # and project pages.  A value of 0 will disable all caching and will parse commits
1201 # in each repository per-request.  If the value > 0 these pages will try to fulfill
1202 # requests using the commit cache.  If the request specifies a period which falls
1203 # outside the commit cache window, then the cache will be ignored and the request
1204 # will be fulfilled by brute-force parsing all relevant commits per-repository.
1205 #
1206 # Consider the values specified for *web.activityDurationChoices* when setting
1207 # the cache size AND consider adjusting the JVM -Xmx heap parameter appropriately.
1208 #
1209 # SINCE 1.3.0
1210 # RESTART REQUIRED
1211 web.activityCacheDays = 14
1212
1213 # Case-insensitive list of authors to exclude from metrics.  Useful for
1214 # eliminating bots.
1215 #
1216 # SPACE-DELIMITED
1217 # SINCE 1.3.0
1218 web.metricAuthorExclusions =
1219
1220 # The number of commits to display on the summary page
1221 # Value must exceed 0 else default of 20 is used
1222 #
1223 # SINCE 0.5.0
1224 web.summaryCommitCount = 16
1225
1226 # The number of tags/branches to display on the summary page.
1227 # -1 = all tags/branches
1228 # 0 = hide tags/branches
1229 # N = N tags/branches
1230 #
1231 # SINCE 0.5.0
1232 web.summaryRefsCount = 5
1233
1234 # Show a README file, if available, on the summary page.
1235 #
1236 # SINCE 1.4.0
1237 web.summaryShowReadme = false
1238
1239 # The number of items to show on a page before showing the first, prev, next
1240 # pagination links.  A default of 50 is used for any invalid value.
1241 #
1242 # SINCE 0.5.0
1243 web.itemsPerPage = 50
1244
1245 # The number of reflog changes to display on the overview page
1246 # Value must exceed 0 else default of 5 is used
1247 #
1248 # SINCE 1.3.0
1249 web.overviewReflogCount = 5
1250
1251 # The number of reflog changes to show on a reflog page before show the first,
1252 #  prev, next pagination links.  A default of 10 is used for any invalid value.
1253 #
1254 # SINCE 1.3.0
1255 web.reflogChangesPerPage = 10
1256
1257 # Specify the names of documents in the root of your repository to be displayed
1258 # in tabs on your repository docs page.  If the name is not found in the root
1259 # then no tab is added.  The order specified is the order displayed.  Do not
1260 # specify a file extension as the aggregation of markup extensions + txt are used
1261 # in the search algorithm.
1262 #
1263 # SPACE-DELIMITED
1264 # SINCE 1.4.0
1265 web.documents = readme home index changelog contributing submitting_patches copying license notice authors
1266
1267 # Registered file extensions to ignore during Lucene indexing
1268 #
1269 # SPACE-DELIMITED
1270 # SINCE 0.9.0
1271 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
1272
1273 # Registered extensions for google-code-prettify
1274 #
1275 # SPACE-DELIMITED
1276 # SINCE 0.5.0
1277 web.prettyPrintExtensions = aea agc basic c cbm cl clj cpp cs css dart el erl erlang frm fs go groovy h hpp hs htm html java js latex lisp ll llvm lsp lua ml moxie mumps n nemerle pascal php pl pm 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
1278
1279 # Registered extensions for markdown transformation
1280 #
1281 # SPACE-DELIMITED
1282 # CASE-SENSITIVE
1283 # SINCE 0.5.0
1284 web.markdownExtensions = md mkd markdown MD MKD
1285
1286 # Registered extensions for mediawiki transformation
1287 #
1288 # SPACE-DELIMITED
1289 # CASE-SENSITIVE
1290 # SINCE 1.4.0
1291 web.mediawikiExtensions = mw mediawiki
1292
1293 # Registered extensions for twiki transformation
1294 #
1295 # SPACE-DELIMITED
1296 # CASE-SENSITIVE
1297 # SINCE 1.4.0
1298 web.twikiExtensions = twiki
1299
1300 # Registered extensions for textile transformation
1301 #
1302 # SPACE-DELIMITED
1303 # CASE-SENSITIVE
1304 # SINCE 1.4.0
1305 web.textileExtensions = textile
1306
1307 # Registered extensions for confluence transformation
1308 #
1309 # SPACE-DELIMITED
1310 # CASE-SENSITIVE
1311 # SINCE 1.4.0
1312 web.confluenceExtensions = confluence
1313
1314 # Registered extensions for tracwiki transformation
1315 #
1316 # SPACE-DELIMITED
1317 # CASE-SENSITIVE
1318 # SINCE 1.4.0
1319 web.tracwikiExtensions = tracwiki
1320
1321 # Image extensions
1322 #
1323 # SPACE-DELIMITED
1324 # SINCE 0.5.0
1bfe11 1325 web.imageExtensions = bmp jpg jpeg gif png ico 
0a98a6 1326
SG 1327 # Registered extensions for binary blobs
1328 #
1329 # SPACE-DELIMITED
1330 # SINCE 0.5.0
1331 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
1332
1333 # Aggressive heap management will run the garbage collector on every generated
1334 # page.  This slows down page generation a little but improves heap consumption. 
1335 #
1336 # SINCE 0.5.0
1337 web.aggressiveHeapManagement = false
1338
1339 # Run the webapp in debug mode
1340 #
1341 # SINCE 0.5.0
1342 # RESTART REQUIRED
1343 web.debugMode = false
1344
1345 # Force a default locale for all users, ignoring the browser's settings.
1346 # An empty value allows Gitblit to use the translation preferred by the browser.
1347 #
1348 # Changing this value while the server is running will only affect new sessions.
1349 #
1350 # e.g. web.forceDefaultLocale = en
1351 #
1352 # SINCE 1.3.0
1353 web.forceDefaultLocale = 
1354
1355 # Enable/disable global regex substitutions (i.e. shared across repositories)
1356 #
1357 # SINCE 0.5.0
1358 # DEPRECATED 1.4.0 (migrate to bugtraq instead)
1359 regex.global = true
1360
1361 # Example global regex substitutions
1362 # Use !!! to separate the search pattern and the replace pattern
1363 # searchpattern!!!replacepattern
1364 # SINCE 0.5.0
1365
1366 # regex.global.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://somehost/bug/$3">$3</a>
1367 # SINCE 0.5.0
1368
1369 # Example Gerrit links
1370 # regex.global.changeid = \\b(Change-Id:\\s*)([A-Za-z0-9]*)\\b!!!Change-Id: <a href="http://somehost/r/#q,$2,n,z">$2</a>
1371 # regex.global.reviewedon = \\b(Reviewed-on:\\s*)([A-Za-z0-9:/\\.]*)\\b!!!Reviewed-on: <a href="$2">$2</a>
1372
1373 # Example per-repository regex substitutions overrides global
1374 # SINCE 0.5.0
1375 # regex.myrepository.bug = \\b(Bug:)(\\s*[#]?|-){0,1}(\\d+)\\b!!!Bug: <a href="http://elsewhere/bug/$3">$3</a>
1376
1377 #
1378 # Mail Settings
1379 # SINCE 0.6.0
1380 #
1381 # Mail settings are used to notify administrators of received federation proposals
1382 #
1383
1384 # ip or hostname of smtp server
1385 #
1386 # SINCE 0.6.0
1387 mail.server =
1388
1389 # port to use for smtp requests
1390 #
1391 # SINCE 0.6.0
1392 mail.port = 25
1393
1394 # debug the mail executor
1395 #
1396 # SINCE 0.6.0
1397 mail.debug = false
1398
1399 # use SMTPs flag
1400 mail.smtps = false
1401
1402 # use STARTTLS flag
1403 #
1404 # SINCE 1.6.0
1405 mail.starttls = false
1406
1407 # if your smtp server requires authentication, supply the credentials here
1408 #
1409 # SINCE 0.6.0
1410 mail.username =
1411 # SINCE 0.6.0
1412 mail.password =
1413
1414 # from address for generated emails
1415 #
1416 # SINCE 0.6.0
1417 mail.fromAddress = 
1418
1419 # List of email addresses for the Gitblit administrators
1420 #
1421 # SPACE-DELIMITED
1422 # SINCE 0.6.0
1423 mail.adminAddresses = 
1424
1425 # List of email addresses for sending push email notifications.
1426 #
1427 # This key currently requires use of the sendemail.groovy hook script.
1428 # If you set sendemail.groovy in *groovy.postReceiveScripts* then email
1429 # notifications for all repositories (regardless of access restrictions!)
1430 # will be sent to these addresses.
1431 #
1432 # SPACE-DELIMITED
1433 # SINCE 0.8.0
1434 mail.mailingLists =
1435
1436 #
1437 # Federation Settings
1438 # SINCE 0.6.0
1439 #
1440 # A Gitblit federation is a way to backup one Gitblit instance to another.
1441 #
1442 # *git.enableGitServlet* must be true to use this feature.
1443
1444 # Your federation name is used for federation status acknowledgments.  If it is
1445 # unset, and you elect to send a status acknowledgment, your Gitblit instance
1446 # will be identified by its hostname, if available, else your internal ip address.
1447 # The source Gitblit instance will also append your external IP address to your
1448 # identification to differentiate multiple pulling systems behind a single proxy.
1449 #
1450 # SINCE 0.6.0
1451 federation.name =
1452
1453 # Specify the passphrase of this Gitblit instance.
1454 #
1455 # An unspecified (empty) passphrase disables processing federation requests.
1456 #
1457 # This value can be anything you want: an integer, a sentence, an haiku, etc.
1458 # Keep the value simple, though, to avoid Java properties file encoding issues.
1459 #
1460 # Changing your passphrase will break any registrations you have established with other
1461 # Gitblit instances.
1462 #
1463 # CASE-SENSITIVE
1464 # SINCE 0.6.0
1465 # RESTART REQUIRED *(only to enable or disable federation)*
1466 federation.passphrase =
1467
1468 # Control whether or not this Gitblit instance can receive federation proposals
1469 # from another Gitblit instance.  Registering a federated Gitblit is a manual
1470 # process.  Proposals help to simplify that process by allowing a remote Gitblit
1471 # instance to send your Gitblit instance the federation pull data.
1472 #
1473 # SINCE 0.6.0
1474 federation.allowProposals = false
1475
1476 # The destination folder for cached federation proposals.
1477 # Use forward slashes even on Windows!!
1478 #
1479 # SINCE 0.6.0
1480 # BASEFOLDER
1481 federation.proposalsFolder = ${baseFolder}/proposals
1482
1483 # The default pull frequency if frequency is unspecified on a registration
1484 #
1485 # SINCE 0.6.0
1486 federation.defaultFrequency = 60 mins
1487
1488 # Federation Sets are named groups of repositories.  The Federation Sets are 
1489 # available for selection in the repository settings page.  You can assign a
1490 # repository to one or more sets and then distribute the token for the set.
1491 # This allows you to grant federation pull access to a subset of your available
1492 # repositories.  Tokens for federation sets only grant repository pull access.
1493 #
1494 # SPACE-DELIMITED
1495 # CASE-SENSITIVE
1496 # SINCE 0.6.0
1497 federation.sets = 
1498
1499 # Federation pull registrations
1500 # Registrations are read once, at startup.
1501 #
1502 # RESTART REQUIRED
1503 #
1504 # frequency:
1505 #   The shortest frequency allowed is every 5 minutes
1506 #   Decimal frequency values are cast to integers
1507 #   Frequency values may be specified in mins, hours, or days
1508 #   Values that can not be parsed or are unspecified default to *federation.defaultFrequency*
1509 #
1510 # folder:
1511 #   if unspecified, the folder is *git.repositoriesFolder*
1512 #   if specified, the folder is relative to *git.repositoriesFolder*
1513 #
1514 # bare:
1515 #   if true, each repository will be created as a *bare* repository and will not
1516 #   have a working directory.
1517 #
1518 #   if false, each repository will be created as a normal repository suitable
1519 #   for local work.
1520 #
1521 # mirror:
1522 #   if true, each repository HEAD is reset to *origin/master* after each pull.
1523 #   The repository will be flagged *isFrozen* after the initial clone.
1524 #
1525 #   if false, each repository HEAD will point to the FETCH_HEAD of the initial
1526 #   clone from the origin until pushed to or otherwise manipulated.
1527 #
1528 # mergeAccounts:
1529 #   if true, remote accounts and their permissions are merged into your 
1530 #   users.properties file 
1531 #
1532 # notifyOnError:
1533 #   if true and the mail configuration is properly set, administrators will be
1534 #   notified by email of pull failures
1535 #
1536 # include and exclude:
1537 #   Space-delimited list of repositories to include or exclude from pull
1538 #   may be * wildcard to include or exclude all
1539 #   may use fuzzy match (e.g. org.eclipse.*)
1540
1541 #
1542 # (Nearly) Perfect Mirror example
1543 #
1544
1545 #federation.example1.url = https://go.gitblit.com
1546 #federation.example1.token = 6f3b8a24bf970f17289b234284c94f43eb42f0e4
1547 #federation.example1.frequency = 120 mins
1548 #federation.example1.folder =
1549 #federation.example1.bare = true 
1550 #federation.example1.mirror = true 
1551 #federation.example1.mergeAccounts = true
1552
1553 #
1554 # Advanced Realm Settings
1555 #
1556
1557 # Auto-creates user accounts based on the servlet container principal.  This
1558 # assumes that your Gitblit install is a protected resource and your container's
1559 # authentication process intercepts all Gitblit requests.
1560 #
1561 # SINCE 1.3.0
1562 realm.container.autoCreateAccounts = false
1563
1564 # Allow or prohibit Windows guest account logins
1565 #
1566 # SINCE 1.3.0
1567 realm.windows.allowGuests = false
1568
1569 # Allow user accounts belonging to the BUILTIN\Administrators group to be
1570 # Gitblit administrators.
1571 #
1572 # SINCE 1.4.0
1573 realm.windows.permitBuiltInAdministrators = true
1574
1575 # The default domain for authentication.
1576 #
1577 # If specified, this domain will be used for authentication UNLESS the supplied
1578 # login name manually specifies a domain (.e.g. mydomain\james or james@mydomain)
1579 #
1580 # If unspecified, the username must be specified in UPN format (name@domain).
1581 #
1582 # if "." (dot) is specified, ONLY the local account database will be used.
1583 #
1584 # SINCE 1.3.0
1585 realm.windows.defaultDomain =
1586
1587 # The PAM service name for authentication.
1588 # default: system-auth
1589 #
1590 # SINCE 1.3.1
1591 realm.pam.serviceName = system-auth
1592
1593 # The Apache htpasswd file that contains the users and passwords.
1594 # default: ${baseFolder}/htpasswd
1595 #
1596 # RESTART REQUIRED
1597 # BASEFOLDER
1598 # SINCE 1.3.2
1599 realm.htpasswd.userfile = ${baseFolder}/htpasswd
1600
1601 # Restrict the Salesforce user to members of this org.
1602 # default: 0 (i.e. do not check the Org ID)
1603 #
1604 # SINCE 1.3.0
1605 realm.salesforce.orgId = 0
1606
1607 # URL of the LDAP server.
1608 # To use encrypted transport, use either ldaps:// URL for SSL or ldap+tls:// to
1609 # send StartTLS command.
1610 #
1611 # SINCE 1.0.0
1612 realm.ldap.server = ldap://localhost
1613
1614 # Login username for LDAP searches.
1615 # If this value is unspecified, anonymous LDAP login will be used.
1616
1617 # e.g. mydomain\\username
1618 #
1619 # SINCE 1.0.0
1620 realm.ldap.username = cn=Directory Manager
1621
1622 # Login password for LDAP searches.
1623 #
1624 # SINCE 1.0.0
1625 realm.ldap.password = password
1626
1627 # Bind pattern for Authentication.
1628 # Allow to directly authenticate an user without LDAP Searches.
1629
1630 # e.g. CN=${username},OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
1631 #
1632 # SINCE 1.5.0
1633 realm.ldap.bindpattern = 
1634
1635
1636 # Delegate team membership control to LDAP.
1637 #
1638 # If true, team user memberships will be specified by LDAP groups.  This will
1639 # disable team selection in Edit User and user selection in Edit Team.
1640 #
1641 # If false, LDAP will only be used for authentication and Gitblit will maintain
1642 # team memberships with the *realm.ldap.backingUserService*.
1643 #
1644 # SINCE 1.0.0
1645 realm.ldap.maintainTeams = false
1646
1647 # Root node for all LDAP users
1648 #
1649 # This is the root node from which subtree user searches will begin.
1650 # If blank, Gitblit will search ALL nodes.
1651 #
1652 # SINCE 1.0.0
1653 realm.ldap.accountBase = OU=Users,OU=UserControl,OU=MyOrganization,DC=MyDomain
1654
1655 # Filter criteria for LDAP users
1656 #
1657 # Query pattern to use when searching for a user account. This may be any valid 
1658 # LDAP query expression, including the standard (&) and (|) operators.
1659 #
1660 # Variables may be injected via the ${variableName} syntax.
1661 # Recognized variables are:
1662 #    ${username} - The text entered as the user name
1663 #
1664 # SINCE 1.0.0
1665 realm.ldap.accountPattern = (&(objectClass=person)(sAMAccountName=${username}))
1666
1667 # Root node for all LDAP groups to be used as Gitblit Teams
1668 #
1669 # This is the root node from which subtree team searches will begin.
1670 # If blank, Gitblit will search ALL nodes.  
1671 #
1672 # SINCE 1.0.0
1673 realm.ldap.groupBase = OU=Groups,OU=UserControl,OU=MyOrganization,DC=MyDomain
1674
1675 # Filter criteria for LDAP groups
1676 #
1677 # Query pattern to use when searching for a team. This may be any valid 
1678 # LDAP query expression, including the standard (&) and (|) operators.
1679 #
1680 # Variables may be injected via the ${variableName} syntax.
1681 # Recognized variables are:
1682 #    ${username} - The text entered as the user name
1683 #    ${dn} - The Distinguished Name of the user logged in
1684 #
1685 # All attributes from the LDAP User record are available. For example, if a user
1686 # has an attribute "fullName" set to "John", "(fn=${fullName})" will be 
1687 # translated to "(fn=John)".
1688 #
1689 # SINCE 1.0.0
1690 realm.ldap.groupMemberPattern = (&(objectClass=group)(member=${dn}))
1691
1692 # Filter criteria for empty LDAP groups
1693 #
1694 # Query pattern to use when searching for an empty team. This may be any valid 
1695 # LDAP query expression, including the standard (&) and (|) operators.
1696 #
1697 # default: (&(objectClass=group)(!(member=*)))
1698 # SINCE 1.4.0
1699 realm.ldap.groupEmptyMemberPattern = (&(objectClass=group)(!(member=*)))
1700
1701 # LDAP users or groups that should be given administrator privileges.
1702 #
1703 # Teams are specified with a leading '@' character.  Groups with spaces in the
1704 # name can be entered as "@team name".  This setting only applies when using
1705 # LDAP to maintain team memberships.
1706 #
1707 # e.g. realm.ldap.admins = john @git_admins "@git admins"
1708 #
1709 # SPACE-DELIMITED
1710 # SINCE 1.0.0
1711 realm.ldap.admins = @Git_Admins
1712
1713 # Attribute(s) on the USER record that indicate their display (or full) name.
1714 # Leave blank for no mapping available in LDAP.
1715 #
1716 # This may be a single attribute, or a string of multiple attributes.  Examples:
1717 #  displayName - Uses the attribute 'displayName' on the user record
1718 #  ${personalTitle}. ${givenName} ${surname} - Will concatenate the 3 
1719 #       attributes together, with a '.' after personalTitle
1720 #
1721 # SINCE 1.0.0
1722 realm.ldap.displayName = displayName
1723
1724 # Attribute(s) on the USER record that indicate their email address.
1725 # Leave blank for no mapping available in LDAP.
1726 #
1727 # This may be a single attribute, or a string of multiple attributes.  Examples:
1728 #  email - Uses the attribute 'email' on the user record
1729 #  ${givenName}.${surname}@gitblit.com -Will concatenate the 2 attributes
1730 #       together with a '.' and '@' creating something like first.last@gitblit.com 
1731 #
1732 # SINCE 1.0.0
1733 realm.ldap.email = email
1734
1735 # Attribute on the USER record that indicate their username to be used in gitblit
1736 # when synchronizing users from LDAP
1737 # if blank, Gitblit will use uid
1738 # For MS Active Directory this may be sAMAccountName
1739 #
1740 # SINCE 1.0.0
1741 realm.ldap.uid = uid
1742
1743 # Defines whether to synchronize all LDAP users and teams into the user service
1744 #
1745 # Valid values: true, false
1746 # If left blank, false is assumed
1747 #
1748 # SINCE 1.4.0
1749 realm.ldap.synchronize = false
1750
1751 # Defines the period to be used when synchronizing users and teams from ldap.
1752 #
1753 # Must be of the form '<long> <TimeUnit>' where <TimeUnit> is one of 'MILLISECONDS', 'SECONDS', 'MINUTES', 'HOURS', 'DAYS' 
1754
1755 # default: 5 MINUTES
1756 #
1757 # RESTART REQUIRED
1758 # SINCE 1.4.0
1759 realm.ldap.syncPeriod = 5 MINUTES
1760
1761 # Defines whether to delete non-existent LDAP users from the user service
1762 # during synchronization. depends on  realm.ldap.synchronize = true
1763 #
1764 # Valid values: true, false
1765 # If left blank, true is assumed
1766 #
1767 # SINCE 1.4.0
1768 realm.ldap.removeDeletedUsers = true
1769
1770 # URL of the Redmine.
1771 #
1772 # SINCE 1.2.0
1773 realm.redmine.url = http://example.com/redmine
1774
1775 #
1776 # Gitblit GO Server Settings
1777 # The following settings only affect the integrated GO variant.
1778 #
1779
1780 # The temporary folder to decompress the embedded gitblit webapp. 
1781 #
1782 # SINCE 0.5.0
1783 # RESTART REQUIRED
1784 # BASEFOLDER
1785 server.tempFolder = ${baseFolder}/temp
1786
1787 # Specify the maximum number of concurrent http/https Jetty worker
1788 # threads to allow.  This setting does not affect other threaded
1789 # daemons and components of Gitblit.
1790 #
1791 # SINCE 1.3.0
1792 # RESTART REQUIRED
1793 server.threadPoolSize = 50
1794
1795 # Context path for the GO application.  You might want to change the context
1796 # path if running Gitblit behind a proxy layer such as mod_proxy.
1797 #
1798 # SINCE 0.7.0
1799 # RESTART REQUIRED
1800 server.contextPath = /
1801
1802 # Standard http port to serve.  <= 0 disables this connector.
1803 # On Unix/Linux systems, ports < 1024 require root permissions.
1804 # Recommended value: 80 or 8080
1805 #
1806 # SINCE 0.5.0
1807 # RESTART REQUIRED
1808 server.httpPort = 0
1809
1810 # Secure/SSL https port to serve. <= 0 disables this connector.
1811 # On Unix/Linux systems, ports < 1024 require root permissions.
1812 # Recommended value: 443 or 8443
1813 #
1814 # SINCE 0.5.0
1815 # RESTART REQUIRED
1816 server.httpsPort = 8443
1817
1818 # Automatically redirect http requests to the secure https connector.
1819 #
1820 # This setting requires that you have configured server.httpPort and server.httpsPort.
1821 # Unless you are on a private LAN where you trust all client connections, it is
1822 # recommended to use https for all communications.
1823 #
1824 # SINCE 1.4.0
1825 # RESTART REQUIRED
1826 server.redirectToHttpsPort = false
1827
1828 # Specify the interface for Jetty to bind the standard connector.
1829 # You may specify an ip or an empty value to bind to all interfaces.
1830 # Specifying localhost will result in Gitblit ONLY listening to requests to
1831 # localhost.
1832 #
1833 # SINCE 0.5.0
1834 # RESTART REQUIRED
1835 server.httpBindInterface =
1836
1837 # Specify the interface for Jetty to bind the secure connector.
1838 # You may specify an ip or an empty value to bind to all interfaces.
1839 # Specifying localhost will result in Gitblit ONLY listening to requests to
1840 # localhost.
1841 #
1842 # SINCE 0.5.0
1843 # RESTART REQUIRED
1844 server.httpsBindInterface =
1845
1846 # Alias of certificate to use for https/SSL serving.  If blank the first
1847 # certificate found in the keystore will be used. 
1848 #
1849 # SINCE 1.2.0
1850 # RESTART REQUIRED
1851 server.certificateAlias = localhost
1852
1853 # Password for SSL keystore.
1854 # Keystore password and certificate password must match.
1855 # This is provided for convenience, its probably more secure to set this value
1856 # using the --storePassword command line parameter.
1857 #
1858 # If you are using the official JRE or JDK from Oracle you may not have the
1859 # JCE Unlimited Strength Jurisdiction Policy files bundled with your JVM.  Because
1860 # of this, your store/key password can not exceed 7 characters.  If you require
1861 # longer passwords you may need to install the JCE Unlimited Strength Jurisdiction
1862 # Policy files from Oracle.
1863 #
1864 # http://www.oracle.com/technetwork/java/javase/downloads/index.html
1865 #
1866 # Gitblit and the Gitblit Certificate Authority will both indicate if Unlimited
1867 # Strength encryption is available.
1868 #
1869 # SINCE 0.5.0
1870 # RESTART REQUIRED
1871 server.storePassword = gitblit
1872
1873 # If serving over https (recommended) you might consider requiring clients to
1874 # authenticate with ssl certificates.  If enabled, only https clients with the
1875 # a valid client certificate will be able to access Gitblit.
1876 #
1877 # If disabled, client certificate authentication is optional and will be tried
1878 # first before falling-back to form authentication or basic authentication.
1879 #
1880 # Requiring client certificates to access any of Gitblit may be too extreme,
1881 # consider this carefully.
1882 #
1883 # SINCE 1.2.0
1884 # RESTART REQUIRED
1885 server.requireClientCertificates = false
1886
1887 # Port for shutdown monitor to listen on.
1888 #
1889 # SINCE 0.5.0
1890 # RESTART REQUIRED
1891 server.shutdownPort = 8081