Extension Repositories
Last modified by Thomas Mortagne on 2017/11/28 09:33
Extension Manager support the following repositories:
Contrib connectors:
Configuring Extension Repositories
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:
#-# Repositories to use when searching and downloading extensions.
#-#
#-# The format is <id>:<type>:<url> where
#-# * id can be anything as long as there is only one
#-# * type is the type of the repository (maven, xwiki, etc.)
#-# * url is the URL or the root of the repository
#-#
#-# Here is an example:
# extension.repositories=privatemavenid:maven:http://host.com/private/maven/
# extension.repositories.privatemavenid.auth.user=someuser
# extension.repositories.privatemavenid.auth.password=thepassword
#-#
#-# The default is:
# extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
# extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
#-#
#-# The format is <id>:<type>:<url> where
#-# * id can be anything as long as there is only one
#-# * type is the type of the repository (maven, xwiki, etc.)
#-# * url is the URL or the root of the repository
#-#
#-# Here is an example:
# extension.repositories=privatemavenid:maven:http://host.com/private/maven/
# extension.repositories.privatemavenid.auth.user=someuser
# extension.repositories.privatemavenid.auth.password=thepassword
#-#
#-# The default is:
# extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
# extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
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:
extension.repositories=local:maven:file://${sys:user.home}/.m2/repository
extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
extension.repositories=maven-xwiki:maven:http://nexus.xwiki.org/nexus/content/groups/public
extension.repositories=extensions.xwiki.org:xwiki:http://extensions.xwiki.org/xwiki/rest/
If you wish to add the XWiki Snapshot repo you'd add:
extension.repositories=maven-xwiki-snapshot:maven:http://nexus.xwiki.org/nexus/content/groups/public-snapshots/
If you have installed the Repository Application and you wish to add it as a repository you'd add:
extension.repositories=localxr:xwiki:http://localhost:8080/xwiki/rest/
Since 4.3 it's also possible to associate various properties to each repository.
Here is an example:
extension.repositories=privatemavenid:maven:http://host.com/private/maven/
extension.repositories.privatemavenid.auth.user=someuser
extension.repositories.privatemavenid.auth.password=thepassword
extension.repositories.privatemavenid.auth.user=someuser
extension.repositories.privatemavenid.auth.password=thepassword