Install XWiki without Internet Connection (XIP Package)
Last modified by Eleni Cojocariu on 2026/04/23 13:53
Steps
To install the wiki UI offline using an XIP package:
- Install XWiki using one of the installation mehtods.
- Go to the Downloads Page to install the wiki UI (the XIP Package).
- Select the exact version of the XIP package as the XWiki version you have and click "Download" on that corresponding version.
- Locate the XIP package under the "Production Installation" section of that version.
- Unzip the package into the following directory: <permanentdirectory>/extension/repository.
- If your unzip tool does not recognize the file, Rename it to have a .zip extension.
- Do not overwrite existing files if you are prompted during extraction.
- Ensure that the user running XWiki has write permissions on the extracted files.
- Restart XWiki if it is currently running.
- Access your XWiki by pointing your web browser to
http://localhost:8080/xwiki. - Resume the standard XWiki installation process. The Distribution Wizard will use the locally available extensions instead of downloading them from the Internet.
FAQ
Does XWiki offer XIP packages for Contrib Extensions?
No, XWiki doesn't offer XIP packages for Contrib Extensions. However it's possible to generate these XIPs.
Is there any other way to install XWiki without an internet connection?
Yes, you can:
- Set up a local Extension Repository, either as a Maven Repository or by using the Extension Repository Application. However, you’ll need to prefill it with all the extensions you wish to install when offline, which can be quite complex.
- Install a Standalone (demo) distribution, which contains a default set of wiki Pages.
- Use the Offline Packager Maven plugin.
Why do I get error logs when offline?
The error logs may be caused by the fact that XWiki performs checks at startup and even at runtime, attempting to connect to remote Extension repositories. To prevent these errors, you can disable the connection to the Extension repositories by editing the xwiki.properties config file and adding the following empty property (make sure this is the only property defined with the name):
extension.repositories=More
To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.
