Confluence Installation Guide

This documentation applies to Confluence version 2.7.x. The latest Confluence documentation is available via this link.

Please review the system requirements before installing Confluence.

Client Requirements

You can use the following browser clients to access Confluence:

Internet Explorer 6 or later.
Firefox.
Mozilla-based browsers. (Some do not support Rich Text Editing).

Server Requirements

Antivirus Software Configuration

Antivirus software greatly decreases the performance of Confluence. Antivirus software that intercepts access to the hard disk is particularly detrimental, and may even cause errors in Confluence.

You should configure your antivirus software to ignore the following directories:

Confluence home directory
Confluence's index directory
All database-related directories

The above recommendation is particularly important if you are running Confluence on Windows. No matter how fast your CPUs are and how many cores they have, antivirus software will always seriously slow down your Confluence performance — sometimes to a point where Confluence is impossible to use.

Server Load

Server load depends primarily on the number of users online at once and their usage of Confluence.

Under 25 concurrent users:

1GHz+ CPU Pentium 4 or equivalent
256MB RAM

Over 25 concurrent users:

Dual 2.4GHz CPU Pentium Xeon or equivalent
512MB+ RAM

Over 100 concurrent users:

Dual 2.4GHz CPU Pentium Xeon or equivalent
4GB of RAM

See Server Hardware Requirements Guide for details.

Refer also to the tips on reducing out of memory errors, in particular the section on Permanent Generation Size.

Operating System

Supported operating systems:

Any OS that supports J2EE 1.4 (Refer to the Java 1.4 Support Timeline.)
Windows
Linux
Mac OS X
Solaris
AIX
Unix

Virtual Environments such as VMware are not recommended and thus not supported for clustered Confluence.

Disk Space

Confluence Install Directory - 250MB

Install files
Nightly site backups
Temporary files

Confluence Home Directory or External Database - 250MB minimum

Text content
File attachments

Java

Confluence requires a supported version of the JDK be installed.

Confluence 2.7.0 supports the following Java versions:

JDK 1.4
Java 5
Java 6

Support for JDK 1.4 is being phased out in future Confluence versions. Please see Java 1.4 Support Timeline for more information.

Database

The Confluence installation includes a pre-configured HSQLDB database for evaluation purposes only. For safe production use, you need to configure Confluence to use an external database. This page lists the supported databases.

Supported Databases

If your database does not appear on this list, please read the questions and answers about supported platforms.

The following databases are fully supported:

PostgreSQL 8
MySQL 4.1 (MySQL 5.0 is supported when used with Confluence 2.5 and above)
Oracle 10g
DB2 8.2 (However DB2 on AS/400 is NOT Supported)

The following databases are supported with some workarounds:
Refer to the list of known issues for these databases.

PostgreSQL 7.1
Oracle 8i, 9i
Microsoft SQL Server 2000
Sybase ASE 12.5.1

If you have no preference, we recommend PostgreSQL — it is scalable, free, and easy to set up. For database setup information, see Database Configuration.

Confluence Edition

Confluence can be deployed in either:

Standalone Edition

Ready for production use after connection to an external database
Packaged with Apache Tomcat for performance and scalability
Recommended for evaluation users

Next Standalone Install Guide

EAR-WAR Edition

Deploys into an existing application server
Suitable only for server administrators

Next EAR-WAR Install Guide

Page tree