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. <= 0 disables this service.</span><br/> |
|
255 |
<span style="color:#004000;"># On Unix/Linux systems, ports < 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. <= 0 disables this service.</span><br/> |
|
263 |
<span style="color:#004000;"># On Unix/Linux systems, ports < 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, & push</span><br/> |
|
385 |
<span style="color:#004000;"># PUSH = anonymous view & clone and authenticated push</span><br/> |
|
386 |
<span style="color:#004000;"># CLONE = anonymous view, authenticated clone & push</span><br/> |
|
387 |
<span style="color:#004000;"># VIEW = authenticated view, clone, & 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. <= 0 disables this service.</span><br/> |
|
859 |
<span style="color:#004000;"># On Unix/Linux systems, ports < 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. <= 0 disables concurrent connection throttling.</span><br/> |
|
875 |
<span style="color:#004000;"># If > 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 <= 0 disables all page caching which</span><br/> |
|
1095 |
<span style="color:#004000;"># is the default behavior for Gitblit <= 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 >= 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 > 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:james@mydomain">james@mydomain</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:name@domain)">name@domain)</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 (&) 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;">(&(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 (&) 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;">(&(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 (&) and (|) operators.</span><br/> |
|
1874 |
<span style="color:#004000;"># </span><br/> |
|
1875 |
<span style="color:#004000;"># default: (&(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;">(&(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:first.last@gitblit.com">first.last@gitblit.com</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. <= 0 disables this connector.</span><br/> |
|
1981 |
<span style="color:#004000;"># On Unix/Linux systems, ports < 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. <= 0 disables this connector.</span><br/> |
|
1989 |
<span style="color:#004000;"># On Unix/Linux systems, ports < 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 →</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> |