Installing Confluence EAR-WAR on Resin

This documentation provides a guide to install Confluence on Resin with basic settings and an external database.

On this page:

Step 1. Check the Known Issues

Check the Known Issues for Resin 3.x page before proceeding.

Step 2. Configuring the Confluence War File

1. Download the Confluence EAR/WAR zip file. (You need to click the 'Show all' link to see the EAR/WAR zip file.)
2. Please check your unzip program before extracting the downloaded zip file. Some archive-extract programs cause errors when unzipping the Confluence zip file:
   • Windows users must avoid the Windows built-in unzip utility, as it doesn't extract all the files. Use a third-party unzip program like 7Zip or Winzip.
   • Solaris users will need to use GNU tar to handle the long file names.
3. Extract the downloaded zip file.
4. You have now unzipped your Confluence installation directory, which should contain the version number e.g. confluence-2.10.0 or confluence-2.10.2. This directory will be later referred to as the Confluence installation directory. Inside is a confluence subdirectory, referred to later as the (Exploded) Confluence WAR directory. Record the absolute path to the Confluence WAR directory.
5. Modify confluence-init.properties and set Confluence Home.
   1. Inside the Confluence installation directory, edit /WEB-INF/classes/confluence-init.properties in a text editor.
   2. Now define your Confluence Home directory, by setting the confluence.home property to a directory of your choosing.
      We suggest using different paths for your installation and home directories. This will facilitate upgrades. This is the directory that will contain all of Confluence's configuration, backup and attachment files.
      Tip: Another term for 'Home directory' would be 'data directory'.
6. Add your database driver jar file to the WEB-INF/lib directory. If your driver already exists in the main classpath and is used for other applications, you can skip this step. Check the Database Installation Instructions. If you're not already committed, we recommend Postgres.
7. Rename /WEB-INF/web.resin3.xml to web.xml. Keep the prior web.xml as a backup.

Step 3. Install Confluence in Resin

1. Move the Confluence war directory to Resin's webapps folder. You are deploying the exploded war file which is supported in Resin.

   If you'd like to run Confluence without a context path, rename the folder to ROOT and remove the existing ROOT folder.

Step 4. Starting Confluence

1. Start Resin. Use the shell script in the bin folder or resin.jar in the lib folder.

To access Confluence go to http://localhost:8080/contextPath