This page last changed on Oct 02, 2009 by edawson.
 | These instructions apply to:
- The Standalone distribution of Confluence. The Standalone distribution includes Apache Tomcat as the standalone application server.
- The simplified Windows Automatic Installer for Confluence.
Also, please check the version of Confluence which you are installing. Refer to the documentation home page to verify the latest Confluence version and to find documentation for older versions. |
On this page:
1. Before you Start
 | The Windows automatic installer version has only been tested for evaluation purposes. If you wish to install a production instance of Confluence, please use the .zip for Windows or the .tar.gz for Unix or Linux or Mac OS X versions instead.
For more information on known issues associated with the auto-installer, please refer to CONF-11460. |
Before you start the installation:
- If you are upgrading from an existing Confluence installation, be sure to back up your Confluence Installation Directory and your Confluence Home Directory, as directed in the Upgrade Guide. If you are using an external database, perform a database backup.
- Ensure that your system meets the minimum requirements to run Confluence. For more information, please read the detailed system requirements.
- Have your Confluence license key ready. You can obtain a trial, free or commercial license now, or retrieve your existing license key.
2. Download and Run the Confluence Installer
- Download Confluence, if you have not already done so. Ensure Windows is selected and choose the 'Standalone Evaluation' installation file:
- Click 'Show All' to see all download files.
- Select file 'Standalone Evaluation (Windows Installer)' (atlassian-confluence-x.x.x-evaluation.exe).
- Save the downloaded file onto your computer.
- When the download is finished, start the Confluence Installer by running the file you have just downloaded:
- Click the downloaded file from your browser's 'Downloads' window.
- Alternatively, you can open the file directly from the location you saved it in — typically your desktop.
The installation wizard will perform some preparation, then the Confluence Installer will display a welcome screen, something like this:
Screenshot: The Confluence Installer's Welcome Screen
 | Hint: The above image and all the images on this page are screenshots. Clicking an image will not install Confluence.
|
Click the 'Next' button to continue with the installation.
3. Define your Installation Directory
Screenshot: Defining the Confluence Installation Directory
The 'Confluence Installation directory' is the directory into which the Confluence application files and libraries have been unpacked (unzipped) when Confluence was installed. Confluence does not modify or store any data in this directory. This directory is also sometimes called the 'Confluence Install directory'.
If you are upgrading from an existing Confluence installation, choose a different Installation Directory i.e. do not overwrite your existing installation.
- Choose where you would like Confluence to be installed. If the directory you choose does not yet exist, the installer will create it for you. Do one of the following:
- Leave the default value supplied for the 'Destination directory'.
- Or click the 'Browse' button and choose another location on your computer.
- Click 'Next'.
4. Define your Home Directory
Screenshot: Defining the Confluence Home Directory
The Confluence Home directory is the folder where Confluence stores its configuration information, search indexes and page attachments. If you're using the embedded HSQLDB database supplied for evaluation purposes, the database files are also stored in this directory.
Tip: Another term for 'Home directory' would be 'data directory'.
If you are upgrading from an existing Confluence installation, choose the same directory as your existing Confluence installation.
- Choose where you would like Confluence to store its configuration data. If the directory you choose does not yet exist, the installer will create it for you. Do one of the following:
- Leave the default value supplied for the location of the Home directory.
- Or click the 'Browse' button and choose another location on your computer.
- Click 'Next'.
5. Choose your Ports if Necessary
Screenshot: Choosing the Ports
If you have another application running on your machine which is using the same ports that Confluence uses by default, you may need to change the port which Confluence will use. For example, if you have a Standalone installation of JIRA running on this machine, JIRA might be already using the port which Confluence requests by default. The Confluence installer will prompt you for alternative ports if necessary, by showing the above screen.
- Enter an alternative 'HTTP Port Number', such as '8090'. This port forms part of the URL you will use to access Confluence in a web browser. By default, Confluence listens on port 8080. In that case, you might use the following address to access Confluence: http://localhost:8080/.
- Enter an alternative 'Control Port Number', such as '8015'. This port is used to start up and shut down Confluence, via the RMI (Remote Method Invocation). By default, Confluence uses port 8005.
- Click 'Next'.
6. Decide whether to run Confluence as a Windows Service
Screenshot: Choosing to Install Confluence as a Windows Service
If you are using Microsoft Windows, you may choose to install Confluence as a Windows Service. This means that Confluence will start up automatically each time you start Windows. By default, the Windows service will run under the Local System account.
You can read more information, for non-Windows users too, on starting Confluence automatically on system startup.
- Put a tick in the checkbox next to 'Run as service' if you would like Confluence to start up automatically each time you start your computer.
- Click 'Next'.
7. Wait while the Installer Extracts and Saves Files
Screenshot: Installation in Progress
The Confluence installer now has enough information. It will start extracting the files from the file you have downloaded, and copying them onto your computer.
This may take a few minutes. When it has finished, you will see the 'Start Confluence in browser' screen as shown below.
8. Decide if you Want to Start Confluence Now
Screenshot: Start Confluence Now?
Place a tick next to 'Start Confluence in browser' if you want to start up Confluence in your web browser now.
9. Exit the Installer
Screenshot: Installation Complete
Congratulations — you have installed Confluence!
Click the 'Finish' button to close the installer.
For Windows users: The installer has added an entry into your Windows Start Menu, called 'Atlassian Confluence'. You will also find an uninstaller and some functions for managing Confluence as a Windows service.
10. Next Step is the Confluence Setup Wizard
If you chose to start Confluence in step 8 above, the Confluence Setup Wizard should appear in your web browser, prompting you to enter your license key. Follow the instructions on the screens, and read more guidelines on the Confluence Setup Wizard.
If an error occurs, check the Installation FAQ page.
RELATED TOPICS
Installation FAQ
Change listen port for Confluence Standalone
Start Confluence automatically on system startup
Adding SSL for Secure Logins and Page Security
Confluence Setup Guide
Configuration Guide
Documentation Home
|