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