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