Show last authors
1 Extension Manager support the following repositories:
2
3 * [[Maven]]
4 * [[XWiki]]
5
6 Contrib connectors:
7
8 * [[Bintray>>doc:Extension.Extension Repository Connector - Bintray.WebHome]]
9 * [[PyPi>>doc:Extension.Extension Repository Connector - Pypi.WebHome]]
10 * [[Npm registry>>doc:Extension.Extension Repository Connector - NPM.WebHome]]
11
12 = Configuring Extension Repositories =
13
14 You can control the list of Repositories to use by setting the ##extension.repositories## property in your ##xwiki.properties## file. Here's the documentation you'll find when editing ##xwiki.properties##:
15
16 {{code language="properties"}}
17 #-# Repositories to use when searching and downloading extensions.
18 #-#
19 #-# The format is <id>:<type>:<url> where
20 #-# * id can be anything as long as there is only one
21 #-# * type is the type of the repository (maven, xwiki, etc.)
22 #-# * url is the URL or the root of the repository
23 #-#
24 #-# Here is an example:
25 # extension.repositories=privatemavenid:maven:http://host.com/private/maven/
26 # extension.repositories.privatemavenid.auth.user=someuser
27 # extension.repositories.privatemavenid.auth.password=thepassword
28 #-#
29 #-# The default is:
30 # extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
31 # extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
32 {{/code}}
33
34 Thus for example if you wish to add your local Maven repository (##/.m2/repository## in this case) so that you can test an extension you'd have built locally with Maven you'd write:
35
36 {{code language="properties"}}
37 extension.repositories=local:maven:file://${sys:user.home}/.m2/repository
38 extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
39 extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
40 {{/code}}
41
42 If you wish to add the XWiki Snapshot repo you'd add:
43
44 {{code language="properties"}}
45 extension.repositories=maven-xwiki-snapshot:maven:http://nexus.xwiki.org/nexus/content/groups/public-snapshots/
46 {{/code}}
47
48 If you have installed the [[Repository Application>>Extension.Repository Application]] and you wish to add it as a repository you'd add:
49
50 {{code language="properties"}}
51 extension.repositories=localxr:xwiki:http://localhost:8080/xwiki/rest/
52 {{/code}}
53
54 Since 4.3 it's also possible to associate various properties to each repository.
55 Here is an example:
56
57 {{code language="properties"}}
58 extension.repositories=privatemavenid:maven:http://host.com/private/maven/
59 extension.repositories.privatemavenid.auth.user=someuser
60 extension.repositories.privatemavenid.auth.password=thepassword
61 {{/code}}
62
63 {{warning}}
64 If your wiki runs behind proxy server, you'd need to make additional configurations in order for extension manager to work properly as described in [[Installation Guide>>http://platform.xwiki.org/xwiki/bin/view/AdminGuide/Installation#HRunningXWikibehindproxy-server]].
65 {{/warning}}
66
67 {{warning}}
68 If you don't plan to let XWiki access any extension repository you can disable default repositories using:
69
70 {{code language="properties"}}
71 extension.repositories=
72 {{/code}}
73 {{/warning}}

Get Connected