This page last changed on Sep 13, 2011 by edawson.

This guide describes how to install a new Confluence installation on Linux using the automated 'Linux Installer'. If you are upgrading Confluence, please see Upgrading Confluence.

Info You can also install Confluence from a 'zip' archive — see Installing Confluence on Linux from Archive File for details.

There are two ways to install Confluence using the Linux Installer:

Using the Console Wizard

Use the console wizard if you are installing Confluence on your server for the first time or you wish to specify your installation options.

If you have previously installed Confluence using the installation wizard and wish to re-install Confluence again with the same installation options, you can re-install Confluence in 'unattended mode' without any user input required (see below for details).

1. Download and Install the Confluence 'Linux Installer'

Tick If you execute the Linux Installer with 'root' user privileges, the installer will create and run Confluence using a dedicated user account. You can also execute the Linux Installer without 'root' user privileges, although your installation options will be much more limited and a dedicated user account (to run Confluence) will not be created. To run Confluence as a service, the Linux Installer must be executed with 'root' user privileges.

  1. Download the appropriate Confluence 'Linux 64-bit / 32-bit Installer' (.bin) file from the Confluence Download page.
    Info Please Note:
    • To access the 32-bit installer, you may need to click the 'Show all' link on the 'Confluence Download' page to access the other installation packages.
    • The difference between the 64-bit / 32-bit .bin installers relates to their bundled Java platforms that run Confluence. Bear in mind that a Confluence installation installed using the 64-bit installer may require additional memory (to run at a similar level of performance) to a Confluence installation installed using the 32-bit installer. This is because a 64-bit Java platform's object references are twice the size as those for a 32-bit Java platform.
  2. Open a Linux console and change directory (cd) to the '.bin' file's directory.
    Warning If the '.bin' file is not executable after downloading it, make it executable, for example:
    chmod a+x atlassian-confluence-X.Y.bin
    (where X.Y represents your version of Confluence)
  3. Execute the '.bin' file to start the console wizard.
  4. When prompted to choose between creating a new Confluence installation or upgrading an existing installation, choose the 'Create a new Confluence installation' option.
  5. During subsequent steps of the console wizard, you will be prompted to customise the following options (which are pre-populated with default values):
    • The 'Destination Directory' in which to install Confluence.
    • The Confluence Home directory (which must be unique for each Confluence installation).
    • The TCP ports (i.e. an HTTP and a Control port) that Confluence will run through.
    • If you are running the installer with 'root' user privileges, you will be prompted to 'Run Confluence as a service' (recommended). You can also do this manually later, as described in Start Confluence Automatically on Linux.
  6. The console wizard will install Confluence onto your operating system and will start Confluence automatically when the wizard finishes.

Info Please Note:

If you executed the Linux Installer with 'root' user privileges, the Linux Installer creates a dedicated Linux user account with username 'confluence', which is used to run Confluence. This account has only:

If you executed the Linux Installer without 'root' user privileges, be aware that Confluence can still be run with 'root' privileges. However, to protect the security of your operating system, this is not recommended.

2. Start Confluence

If Confluence is not already started, you can start Confluence using the appropriate command at the Linux console.

Once Confluence is started, you can access Confluence from a browser on any computer with network access to your Confluence server.

2.1 Starting and Stopping Confluence manually

In the Linux console, enter the bin subdirectory of your Confluence installation directory and execute the appropriate file:

  • start-confluence.sh (to start Confluence)
  • stop-confluence.sh (to stop Confluence)

Confluence will be ready to access (from a browser window) when the following message appears in the application's log file:

*******************************************************
 ... You can now access Confluence through your web browser.
*******************************************************

2.2 Accessing Confluence from a Browser

You can access Confluence from any computer with network access to your Confluence server by opening a supported web browser on the computer and visiting this URL:

  • http://<computer_name_or_IP_address>:<HTTP_port_number>

where:

  • <computer_name_or_IP_address> is the name or IP address of the computer on which Confluence is installed and
  • <HTTP_port_number> is the HTTP port number specified when you installed Confluence (above).

Info If Confluence does not appear, you may need to change the port that Confluence runs on.

Note: Application server logs (i.e. for Apache Tomcat) will be written to logs/catalina.out.

3. Run the Setup Wizard

See the Confluence Setup Guide.

4. Next Steps

Performing an Unattended Installation

If you have previously installed Confluence using the console wizard (above), you can use a configuration file from this Confluence installation (called response.varfile) to re-install Confluence in 'unattended mode' without any user input required.

Installing Confluence in unattended mode saves you time if your previous Confluence installation was used for testing purposes and you need to install Confluence on multiple server machines based on the same configuration.

Warning Please Note:

  • The response.varfile file contains the options specified during the installation wizard steps of your previous Confluence installation. Hence, do not uninstall your previous Confluence installation just yet.
  • If you intend to modify the response.varfile file, please ensure all directory paths specified are absolute, for example, sys.installationDir=/opt/atlassian/confluence
    Unattended installations will fail if any relative directory paths have been specified in this file.

Download and Run the Confluence 'Linux Installer' in Unattended Mode

  1. Download the Confluence 'Linux Installer' (.bin) file from the Confluence Download Center to a suitable location.
  2. Open a Linux console.
  3. Copy (cp) the file .install4j/response.varfile located in your previous Confluence installation directory, to the same location as the downloaded 'Linux Installer' file.
    Info You can uninstall your previous Confluence installation after this step. Save your response.varfile if you need to install Confluence on multiple machines.
  4. Change directory (cd) to the location of the 'Linux Installer' file and execute the following command:

    atlassian-confluence-X.Y.bin -q -varfile response.varfile
    

    Where:

    • X.Y — refers to the version of Confluence you are about to install.
    • -q — instructs the installer to operate in unattended mode (i.e. 'quietly').
    • -varfile response.varfile — specifies the configuration file containing the configuration options used by the installer. The location and name of the configuration file should be specified after the -varfileoption.

  5. Confluence will start automatically when the silent installation finishes. Continue from the step above, Starting Confluence.
Document generated by Confluence on Sep 19, 2011 02:47