This page last changed on Apr 05, 2007 by david.soul@atlassian.com.
Getting the EAR/WAR distribution
- Download the latest EAR/WAR distribution release of Confluence and expand it to a location on your hard disk (we'll call it '$CONFBASE')
- Download confluence-dist.zip file, which contains stripped-down project files for Maven, expand it and copy it's contents into root of your Confluence release ($CONFBASE).
- Open the contained build.properties file in a text editor and adjust it to meet your environment settings. In particular, pay attention to the following:
- JDK Version - This should be set to whatever your target JDK is called in IDEA. On Mac OS X, this is usually '1.4' or '1.5' (without quotes). Eg:
- Application Server Settings - Uncomment these and point to your app server installation. Only uncomment the ones you actually have installed. Eg:
- Application Settings - The settings in which your application server will launch confluence. The settings below will allow you to access the running server at http://localhost:8080/confluence:
Creating the IDEA project files
- Open a command prompt and enter the following:
- That's it! Now just open up the freshly-generated 'confluence.ipr' file in IDEA. It should look something like this:

Setting up the Confluence environment
Once the project is loaded, you will need to set up where the 'confluence home' is.
- Open confluence/WEB-INF/classes/confluence-init.properties
- Set the 'confluence.home' property to the location you want confluence data stored. An example might be $CONFBASE/confluence/home, or somewhere in your home directory. If the location doesn't exist, Confluence will try to create it when you run the webapp.
Compiling and running Confluence
Now that it's set up, we should make sure it's all working by getting it to run inside IDEA.
- Click the 'confluence' module and then select 'Build > Make Project' from the menu. Alternately, click the
button.
- From the drop-down beside the
button, select your app server (eg. 'Tomcat').
- Click the
button next to the app server drop-down.
 |
The most common problem here is that the JDK has not been set up correctly. If you have a problem, check the following:
- Right-click on the 'confluence' module in the project window and select 'Module Settings' at the bottom of the popup-window.
- Select the 'Libraries' tab
- Check that a valid JDK has been selected for the module.
- Check the other modules in the project for the same.
|
What's Next?
Now that we've got Confluence running, we can start working on plugins.
|