Installing JSPWiki on an XAMPP for Windows install

I’ve been experimenting with XAMPP as a way to setup a temporary and transportable Apache install with PHP, MySQL, and a database admin tool (phpMyAdmin). Before starting, be sure to have Sun J2EE 5.x SDK (or higher) installed.

As mentioned on, by following the “Installation” without the installer instructions, XAMPP will run from a removable drive (I’m using an SD card, myself–quite a bit slower than other options, but VERY cheap).

First, I downloaded the ZIP package from from the xampp for windows page:

Open the xampp-win32-*.*.*.zip file that was just downloaded and extract to C: (change to flash drive drive letter here if necessary).

Run [drive]:xamppxampp_start.exe to test starting up the web server and mysql.
Run [drive]:xamppxampp_stop.exe to shut the web server and mysql down again.

Next download the Apache Tomcat plug-in from the XAMPP for Windows Add-Ons area.

Extract this .zip file into to the c:xampp folder (again, substitute c: for appropriate drive letter if necessary). You should get a “Confile File Overwrite” prompt when you do this–the Tomcat files should overwrite the original xampp files, so select [Yes to All].

After the Tomcat files have been extracted, run [drive]:xamppsetup_xampp.bat to setup Tomcat.

Test the installation by running

  • [drive]:xamppxampp_start.exe to start xampp, then
  • [drive]:xampptomcat_start.bat to start Tomcat.
  • Browse to http://localhost:8080, which should be something like the following:

Finally download JSPWiki (Current stable release):

Extract the JSPWiki.war file from the JSPWiki download and copy to the [drive]:xampptomcatwebapps folder.

Run [drive]:xampptomcat_stop.bat and then [drive]:xampptomcat_start.bat to restart Tomcat. Web application JSPWiki should get loaded as part of the restart. I had to restart a second time (probably started too soon after shutting down.)

Browse to http://localhost:8080/JSPWiki to view the JSPWiki page. You will be prompted to begin installation:

For the installation options, I used:

  • Application name – JSPWiki
  • BaseURL – http://localhost:8080/JSPWiki/
  • Page Storage – /p/web/www-data/jspwiki/ (default) — note that this will be the path off of your root drive wherever xampp and Tomcat are running from. This is where the wiki pages will be stored.
  • All other options – default values


  • Press [Configure!]
  • [drive]:xampptomcat_stop.bat to stop Tomcat.
  • [drive]:xampptomcat_start.bat to start Tomcat.
  • Browse to http://localhost:8080/JSPWiki/ to start using your JSPWiki. By default, versioning is turned on, which is accomplished by storing every version of the file in an “OLD” folder just off the main page storage folder.

Troubleshooting JSPWiki Installation

, ,

Leave a Reply

%d bloggers like this: