Hardware and Software requirements

See Prerequisites.

Installation Methods

For testing XWiki, we highly recommend one of the following installation method:

• Using XWiki in the cloud: This is by far the simplest to try XWiki since you don't need to install anything.
• Using a standalone distribution : Provides a built-in XWiki, with a portable database (HSQLDB) and a lightweight Java container (Jetty). This standalone distribution is not recommended in a production environment (check the DB limitations). If you need to use it in a production basis, you may look at the other options.
• Using an official XWiki Docker image: Provides an easy solution to test XWiki, with a configuration very close to a production setup.

For production installations, we recommend the following installation method:

• Using .deb package (usable for production): Provides a .deb package that can be used on a Debian-based operating system. It can be installed with dpkg or apt; installation is thus automated.
• Using an official XWiki Docker image: You can also use this method in production if you're used to putting Docker images in production.

Last, you could manually deploy XWiki as a WAR into the Servlet Container of your choice and on the Database of your choice, if the previous methods were not good enough for your needs. Beware that this requires some technical knowledge about Servlet Container and Databases:

• Using .war package (usable for production): Provides a Java application package that has to be installed in a Java container (such as Tomcat). This can be used on almost any operating system.

Whatever the installation method, you should make sure to create the database indexes manually for indexes that are not created automatically.

Other Installation Methods

See Unofficial installation methods.

Accessing your wiki

Once you've installed XWiki using one of the methods defined above, you can access it by pointing your web browser to http://localhost:8080/xwiki.

HTTP Proxy

You now have a working XWiki instance but it's often a good idea to access it through an HTTP proxy especially when you plan to access it through the standard HTTP/HTTPS port instead of 8080.

• Apache HTTPD
• NginX

Troubleshooting

See Troubleshooting.

What to do with an empty XWiki?

 See Multiple Instances of XWiki in the Same Container.           

Running XWiki behind a proxy server

See XWiki behind a Proxy Server.

Debugging proxy configuration issues

See Debug Proxy Configuration.

Unsupported major.minor version 51.0

This is because starting with version 6.0, XWiki requires Java 7 and you're using Java 6. You need to upgrade your Java version.

See Install XWiki without Internet.

Getting an error about SSL certificate

See Installation.

"File path too long" on Windows when unzipping

See Installation.