Installing Confluence Standalone

This install guide is for users running Windows, Mac OS X, Solaris, Unix or Linux.

注意

• You must be able to use a command prompt and install Java to continue. If not, please contact your system administrator to assist you or consider the Online Trial
• Have your licence key ready. You can obtain a trial, free or commercial licence now, or retrieve your existing key
• Help is available under Troubleshooting

STAGE 1 - Install The Java Developers Kit

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

• はい
• No, or not sure

(Mac users can go straight to STAGE 2, as OS X comes with a Java Development Kit.)

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. Type the following in the command prompt and then press Enter:
   • If you are using Windows OS: echo %JAVA_HOME%
   • If you are using Unix: echo $JAVA_HOME
     If a line is displayed such as C:\Progra~1\Java\jdk1.5.0_06 with the last two letters being dk, the JDK is installed. If nothing is displayed, or the last two letters in the path are not dk, follow the 'No, or not sure' instructions.
     
     
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
• Unix, Linux or Solaris
• Mac
  
  
  

  The Install Directory is also referred to as the <Confluence-Install> Directory.
  The Home Directory is also referred to as the <Confluence-Home> Directory.

  
  
  

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.6.0-std           <-- <Confluence-Install> directory, unzipped now
   c:\confluence\data                            <-- <Confluence-Home> directory, created next
   

   You have now created your <Confluence-Install> directory. This is the directory where you unzipped Confluence, for example c:\confluence\confluence-2.6.0-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 TAR
   
   
3. Use your unzip program to unzip the install file to a directory such as /home/jsmith/confluence-2.6.0-std/, 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

   /home/jsmith/confluence-2.6.0-std/                     <-- <Confluence-Install> directory, unzipped now
   /home/jsmith/confluence-data/confluence-2.6.0-std/     <-- <Confluence-Home> directory, created next
   

   You have now created your <Confluence-Install> directory. This is the directory where you unzipped Confluence, for example /home/jsmith/confluence-2.6.0-std/
   
   
4. Go to STAGE 3

Mac OS X 10.3 or 10.4

1. Before you begin, it is recommended that you run Software Update to ensure that your operating system is up to date.
   
   
2. If you have not downloaded Confluence already, download the Standalone ZIP.
   
   
3. Find the downloaded file in the Finder. Double-click on the file to extract it to a directory called confluence-2.6.0-std (or similar).
   
   
4. Move this folder to wherever you want to keep your Confluence installation (for example, under your user's home folder). Ensure that there are no spaces in the folder name, or in the names of any of its parent folders. This folder that includes the Confluence application is called the <Confluence-Install> folder.
   
   
5. Create a folder named confluence-data. You can create this anywhere, e.g. in your home folder, but not inside the <Confluence-Install> directory. Ensure that there are no spaces in the folder name, or in the names of any of its parent folders. Create this folder in the Finder, using the 'New Folder' command in the 'File' menu. This folder is called the <Confluence-Home> folder.
   
   
6. You now need to set up an environment variable which tells Confluence where your Java Virtual Machine is installed. Inside the <Confluence-Install> folder, edit the file bin/setenv.sh. Open it with TextEdit, and add the following line as the first line of the file:

   export JAVA_HOME=/Library/Java/Home
   

   
   
   
7. Go to STAGE 3

STAGE 3 - Set Your Home Directory

This stage creates a Home directory where Confluence will store its 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 (Windows) or TextEdit (Mac).
   
   
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 <Confluence-Home> directory will be.
   • Windows users should use the default c:\confluence\data for simplicity but you can choose any directory that does not contain a space in the path.
   • Mac users should use the <Confluence-Home> folder they created earlier.
     
     
7. If you are using a different <Confluence-Home> directory from c:\confluence\data, edit the line now.
   • Windows users must use / characters to separate each directory in the path. Windows users can save the <Confluence-Home> directory as the default by saving the line as

     confluence.home=c:/confluence/data
     

   • Linux users should specify <Confluence-Home> using the absolute path instead of a symbolic link, e.g:

     confluence.home=/home/jsmith/confluence-data
     

   • Mac users should place the cursor after the '=' sign, find the the <Confluence-Home> folder which you created earlier and drag it to TextEdit. This will insert the full path of the folder into the file. It's important to make sure that you deleted the leading '#' character, and that the path after the '=' sign starts with a '/' character. The line should now look something like this:

     confluence.home=/Users/jsmith/confluence-data
     

     
     

You have now set your <Confluence-Home> directory.

STAGE 4 - Check the Ports

If you have another Tomcat instance running on the same machine, you may need to change the port which Confluence is listening on. By default, Confluence is listening on port 8080. If this port is already used in your installation, follow these instructions to change the port.

STAGE 5 - Review Release Notes

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

STAGE 6 - Prepare for LDAP Integration

Perform this step before setting up Confluence, if you're doing a fresh install of Confluence 2.6.x and you intend to integrate with an LDAP server,

1. Change your <Confluence-Install>/confluence/web-inf/classes/atlassian-user.xml to the following:

   <atlassian-user>
       <repositories>
           <hibernate name="Hibernate Repository" key="hibernateRepository"  description="Hibernate Repository" cache="true"/>
       </repositories>
   </atlassian-user>
   

Incorporating the above changes will allow you to skip the 'User Migration' steps, which are otherwise required during LDAP integration with Confluence.

STAGE 7 - Start Confluence

To start Confluence for the first time,

1. Go to your <Confluence-Install> directory
   
   
2. Under your <Confluence-Install> directory, open the bin directory and run the startup script. Windows users run startup.bat while users with other operating systems run startup.sh
   
   Mac users will be prompted by OS X to choose an application to use. Choose the Terminal application, which is inside
   the Utilities folder.
   
   If the window closes immediately when started, click here for assistance

   
   

   An error is preventing Confluence from starting. To view this error:
   1. Open a command prompt. On Windows, do this by clicking on your Start menu, then click Run. In the Run box, type cmd and press OK
   3. From the command prompt, go to your <Confluence-Install> directory
   4. Go into the bin subdirectory
   5. Run startup.bat and read the error message
   6. Find the solution to that error in the Troubleshooting section

   
   
   
   
   
   

   
   
   
3. Once Confluence is running, open a web browser and visit http://localhost:8080/. (If you changed the port earlier, use the port you specified in STAGE 4 above.)

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

関連トピック

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