Installing the Standalone Distribution

Version 2.1 by Guillaume Fenollar on 2012/01/25

This is by far the easiest way to install XWiki. We are offering 3 packaging for ease of installation:

  • A Windows exe. Simply execute it and follow the instructions. Do not close the DOS Windows that shows up. This is the XWiki server running, instead point your browser tohttp://www.localhost:8080/.
  • A generic Installer that works on all platforms. It requires Java to be installed on your system. Simply double-click on it and follow the instructions.
  • A zip version. Unzip it in any XWIKIHOME directory of your choice.

The Windows installer creates shortcuts to start and stop XWiki in your Windows start menu. Launch the Wiki using "start".

If you've used the zip file or generic Installer, go to the directory where you've installed XWiki (XWIKIHOME) and run start_xwiki.bat in Windows or start_xwiki.sh on Unix. To stop it, run the stop_xwiki.bat script on Windows and stop_xwiki.sh on Unix or Mac. On Mac you will need to use "Open with Terminal" or run this script from the Terminal.

Once XWiki is started point your browser tohttp://localhost:8080/and the go to the User's Guide to learn how to use XWiki.

In some cases, you might already have a Web Server running on port 8080. If this happens you have to pass another the port to the start script (e.g. by using the port 8081, as in start_xwiki.sh 8081).

You can log in using the default Admin user (first letter is capitalized). The default password is admin (lowercase).

Get Connected