Hide last authors
Thomas Mortagne 2.1 1 Extension Manager support the following repositories:
2
Thomas Mortagne 9.1 3 * [[Maven]]
4 * [[XWiki]]
Krzysztof Płachno 11.1 5
6 Contrib connectors:
Thomas Mortagne 2.1 7
Thomas Mortagne 12.1 8 * [[Bintray>>doc:Extension.Extension Repository Connector - Bintray.WebHome]]
9 * [[PyPi>>doc:Extension.Extension Repository Connector - Pypi.WebHome]]
Thomas Mortagne 14.1 10 * [[Npm registry>>doc:Extension.Extension Repository Connector - NPM.WebHome]]
Krzysztof Płachno 10.1 11
Thomas Mortagne 1.1 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
Thomas Mortagne 7.1 16 {{code language="properties"}}
Thomas Mortagne 1.1 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 #-#
Thomas Mortagne 7.1 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 #-#
Thomas Mortagne 1.1 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
Thomas Mortagne 8.2 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:
Thomas Mortagne 1.1 35
Thomas Mortagne 7.1 36 {{code language="properties"}}
Thomas Mortagne 1.1 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
Thomas Mortagne 7.1 44 {{code language="properties"}}
Thomas Mortagne 1.1 45 extension.repositories=maven-xwiki-snapshot:maven:http://nexus.xwiki.org/nexus/content/groups/public-snapshots/
46 {{/code}}
47
Thomas Mortagne 8.2 48 If you have installed the [[Repository Application>>Extension.Repository Application]] and you wish to add it as a repository you'd add:
Thomas Mortagne 1.1 49
Thomas Mortagne 7.1 50 {{code language="properties"}}
Thomas Mortagne 1.1 51 extension.repositories=localxr:xwiki:http://localhost:8080/xwiki/rest/
52 {{/code}}
53
Thomas Mortagne 8.1 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
Thomas Mortagne 1.1 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]].
Thomas Mortagne 16.1 65 {{/warning}}
Thomas Mortagne 15.1 66
Thomas Mortagne 16.1 67 {{warning}}
Thomas Mortagne 15.1 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}}
Thomas Mortagne 1.1 73 {{/warning}}

Get Connected