This page last changed on Mar 14, 2007 by david.soul@atlassian.com.

This install guide is for users running Windows, Solaris, Unix or Linux. OS X users should use this document instead.

Notes

STAGE 1 - Install The Java Developers Kit

Do you already have the Java Developers Kit 1.4 or newer installed?




JDK 1.5 Or Earlier

You must confirm the JDK is installed correctly:

  1. Open a command prompt. On Windows this is done by opening your Start menu and selecting Run, then typing cmd and pressing OK

  2. In the command prompt, type echo %JAVA_HOME% and press Enter
    If a line is printed such as C:\Progra~1\Java\jdk1.5.0_06 with the last two letters being dk, the JDK is installed. If nothing is printed, or the last two letters in the path are not dk, click the 'No, or unsure' instructions and follow those

  3. Users who have installed a non-Sun JDK must install the Sun JSSE package

  4. Go to STAGE 2




JDK Unknown or Not Installed

Install the JDK:

  1. Download JDK 1.5_08 to the Confluence server

  2. Once downloaded, run the installer. At one point, you will be asked to choose a directory to install to. Copy or write this directory down for use later

  3. Windows users follow these instructions to set your JAVA_HOME environment variable to the directory you just installed the JDK in. The default directory is under C:\Program Files\Java

  4. Go to STAGE 2

STAGE 2 - Download & Unzip Confluence

Select your operating system:


Windows

  1. The default Windows unzipper cannot unzip Confluence
    If you have already unzipped Confluence using the default Windows unzip, delete the directory created now

  2. You will need a third-party unzip program like 7Zip or Winzip. If you do not have one, download and install one before continuing:
    • 7Zip Recommended. If in doubt, download the '32-bit .exe' version
    • Winzip

  3. If you have not downloaded Confluence already, download the Standalone zip

  4. Use your unzip program to unzip the install file to a directory such as c:\confluence, avoiding directories with spaces. To make upgrades easier, Windows users should aim to create a directory structure like below:
    c:\confluence\confluence-2.2.10-std           <-- Install directory, unzipped now
    c:\confluence\data                            <-- Home directory, created next


    You have now created your install directory. This is the directory where you unzipped Confluence, for example c:\confluence\confluence-2.2.10-std
  5. Go to STAGE 3




Unix, Linux or Solaris

  1. Install these X11 libraries

  2. If you have not downloaded Confluence already, download the Standalone zip

  3. Use your unzip program to unzip the install file to a directory such as c:\confluence, avoiding directories with spaces. Linux or Unix users can use any unzip program to unzip Confluence, but Solaris users must use GNU Tar instead of Solaris Tar
    You have now created your install directory. This is the directory where you unzipped Confluence, for example c:\confluence\confluence-2.2.10-std

  4. Go to STAGE 3

STAGE 3 - Set Your Home Directory

This stage creates a Home directory where Confluence will store it's configuration information, indexes and attachments.

  1. Open your Confluence install directory

  2. Under the install directory, find \confluence\WEB-INF\classes\confluence-init.properties| |
  3. Open the file confluence-init.properties in a text editor such as Notepad

  4. Scroll to the bottom and find the line
    # confluence.home=c:/confluence/data

  5. Remove the '#' and the space at the front of this line to uncomment it. It should now begin with confluence.home

  6. Choose what your Home directory will be. Windows users should use the default c:\confluence\data for simplicity but you can chose any directory that does not contain a space in the path

  7. If you are using a different Home directory from c:\confluence\data, edit the line now. Windows users must use / characters to separate each directory in the path. Linux users should specify Home using the absolute path instead of a symbolic link

    Windows users can save the Home directory as the default by saving the line as
    confluence.home=c:/confluence/data

You have now set your Home directory.

STAGE 4 - Review Release Notes

Review the Release Notes for your Confluence version and apply any patches listed.

STAGE 5 - Start Confluence

To start Confluence for the first time,

  1. Go to your install directory

  2. Under your install directory, open the bin directory and run the startup script. Windows users run \bin\startup.bat while users with other operating systems run /bin/startup.sh| |

    If the window closes immediately when started, click here for assistance


  3. Once Confluence is running, open a web browser and visit http://localhost:8080/

The Confluence Setup Wizard should appear for you to enter your licence key. If the address shows an error, check the Troubleshooting section

NEXT STEP

Proceed to the Confluence Setup Wizard Guide

TROUBLESHOOTING


Solutions to common issues with installing Confluence. Click on a problem to show the solution.

Confluence window closes immediately when started

Confluence won't start - java.lang.NoClassDefFoundError IntraHibernateAttachmentCopier

Confluence won't start - Error creating Confluence Home directory

Confluence won't start - JAVA_HOME environment variable is not defined correctly

Confluence won't start - Port 8080 is in use

Confluence won't start - Error creating bean with name 'scheduler'

Confluence won't start - Error registering bean with name 'fileSystemAttachmentDataDao'

Confluence starts but localhost:8080 times out

Confluence starts but localhost:8080 goes to Tomcat start homepage

Confluence starts but logins fail at login screen


RELATED TOPICS

Change listen port for Confluence Standalone
Adding SSL on Confluence 2.1.5a and earlier
Confluence Setup Guide
Configuration Guide
Documentation Home


Confluence Installation OS X.pdf (application/pdf)
confluence-init.jpg (image/jpeg)
confluence-init.jpg (image/jpeg)
startup.jpg (image/jpeg)
arrow_closed_active_16.gif (image/gif)

Stage 2, Unix/Linux section, step 3 mentions windows type of path. In reality it'll most likely to be /opt/confluence or /home/confluence/

Posted by andrek at Mar 07, 2007 19:59
Document generated by Confluence on Mar 22, 2007 20:56