This page last changed on Apr 24, 2008 by jlargman.
This guide describes building a confluence.war distribution or an IDE project from the Confluence source code. Plugin developers who wish to use source code as an aid in building plugins should refer to the plugin documentation. This process should be simple and quick, so please let us know if you get stuck.
Building a war distribution
- Download Confluence source code.
 | Source code access is available for commercial license holders. If you do not have access to the source code download site, log in to my.atlassian.com as your billing contact or contact our sales department. |
- Confluence is built using Maven. Maven is bundled with the source distribution and therefore does not need to be installed separately. When you build Confluence, Maven will download dependencies and store them in a local repository. One of these dependencies requires manual installation for legal distribution reasons. If you do not already have it in your private repository, download JavaMail from Sun's website.
 | Sun will not allow Maven to redistribute its binaries. You must install all Sun binaries manually by downloading them from Sun's website and running the mvn install command. Maven has provided documentation for both 3rd party jars in general and Sun jars in particular. |
Unzip the mail.jar file from the javamail-1_x_x.zip file. From the root of your extracted source code directory, run:
.\maven\bin\mvn install:install-file -DgroupId=javax.mail -DartifactId=mail -Dversion=1.x.x -Dpackaging=jar -Dfile=Path/To/mail.jar
Where Path/To/mail.jar is the absolute path to the extracted mail.jar file.
- Open build.sh (Unix/Linux/Mac) or build.bat (Windows) in a text editor. On the line where mvn is invoked, add the -Dmaven.test.skip parameter. Your .sh script will look like this (the .bat file is slightly different):
Due to the requirement for a Confluence license, the built-in tests will not pass using the source release so you need to skip them.
- Run your build script.
If the build is run successfully you should have a confluence.war file created in ../confluence-project/conf-webapp/target/. If the build was unsuccessful, please create a support request at http://support.atlassian.com and attach the full output from the script to your support request.
Building an Intellij Idea or an Eclipse project
To build a project for an IDE, you can use the instructions above, but modify the build.sh or build.bat mvn command:
This should leave a project file in the root of your source directory. It should have all the confluence modules.
While we encourage our community to make use of our source code, we also caution that upgrades may be more difficult and modifications to source code are not supported.
 |
Source code modifications are not supported by Atlassain Support. |
RELATED TOPICS:
FAQ and Troubleshooting
How to Build an Atlassian Plugin
Working with Sun Java Libraries
|