Documentation for Confluence 5.5.
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

This guide describes how to install a new Confluence installation on Linux using the automated 'Linux Installer'. You can also install from a 'zip' archive — see Installing Confluence on Linux from Archive File for details.
If you are upgrading Confluence, please see Upgrading Confluence.

(warning) Please Note:

  • It is possible that any anti-virus or other Internet security tools installed on your Linux operating system may interfere with the Confluence installation process and prevent the process from completing successfully. If you experience or anticipate experiencing such an issue with your anti-virus/Internet security tool, disable this tool first before proceeding with the Confluence installation.
  • You may also wish to consider disabling the Linux OutOfMemory Killer (OOM Killer). This is a Linux function that can kill processes when memory on the server becomes low, and sometimes targets Confluence.
  • Before you begin installing Confluence, please read the System Requirements page.

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 'Express Install', 'Custom Install' or 'Upgrade an existing Confluence installation', choose either the 'Express Install' or 'Custom Install' options:
    • Express Install — If you choose this option, Confluence will be installed with default settings which are shown in the next step of the console wizard.
      (info) Please Note:
      • If you are running the installer with 'root' user privileges, Confluence will be installed as a service.
      • If you want to customise any of these options:
        1. Enter 'e' to exit the console wizard.
        2. Execute the console wizard again (step 3 above).
        3. Choose the 'Custom Install' option instead.
    • Custom Install — If you choose this option, Confluence will prompt you to specify the following options (which are presented during subsequent steps of the console wizard and 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.
  5. 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:

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.
  • No labels

31 Comments

  1. For support and troubleshooting help, please open a support request at http://support.atlassian.com, where our support engineers will be able to get back to you quickly.

    Best Regards,

    Edwin Dawson
    Technical Writing Team Leader
    Atlassian
    http://www.atlassian.com

  2. Anonymous

    There doesn't appear to be any *.bin installer package available for download, where exactly might this be found?

    1. Hi there,

      As this documentation relates to Beta versions of Confluence 4.0, you will need to visit the EAP Downloads page. From there, you'll find the Linux binaries.

      I hope this helps.

      Best Regards,

      Edwin Dawson
      Technical Writing Team Leader
      Atlassian
      http://www.atlassian.com

  3. First, dumb question: How do I decide between 32 and 64 bit versions? Second, Edwin's comment about "Beta versions of Confluence 4.0" makes me wonder how much of this page is out of date.

  4. 'Installation directory' = 'Destination Directory'?

  5. Anonymous

    Upgraded from 3.5.7 using 4.1.4-x64 binary installer.  It did not create the confluence user and it's still running as root.  You have to follow the directions here: Start Confluence Automatically on Linux and then make sure to chown, chmod and chgrp your confluence and confluence-data directories so confluence user can write to them.

     

  6. Anonymous

    Ok, did the install and now there is a confluence user - but what the heck is the password for this user?

  7. Anonymous

    The confluence user is just created like any other user in POSIX style linux, but created without a password. To set a password: As 'root' (or using 'sudo') run "passwd confluence" from a command prompt. It will then prompt you to enter a new password for the confluence user. Choose a password and enter it twice. You can now login as confluence with that password.

     

    P.S. For better convenience, you can set the confluence user to use a bash prompt instead of the default '/bin/sh'. As root, run this: "usermod -s /bin/bash confluence".

  8. Anonymous

    Hi, I have just installed Confluence for the second time and fell over the same problem as the first time. On SLES it looks like the confluence user should be created BEFORE installation otherwise the /opt/atlassian directory doesnt have the correct permissions (I guess the adduser failed in some way as there was no such user at the end of the install)

    Watch out for just repeating the installation - the installer detects the directories exists and wont overwrite them. I guess the "upgrade" option would sorted that.

     

    1. Anonymous

      well this worked for me......................

      1. install confluence using the *.bin file
      2. useradd confluence
      3. install confluence again but as an UPGRADE

      If you try to start confluence by hand after step 1 you will get an error - confluence user doesnt exist. However if you then start it after step 3 you have tomcat already running (thing restart works)

  9. Anonymous

    I get the following error when trying to install:

    Unpacking JRE ...
    Starting Installer ...
    ./atlassian-confluence-4.2.13-x32.bin: 466: /root/atlassian-confluence-4.2.13-x32.bin.17513.dir/jre/bin/java: not found

    Running Ubuntu 11.04

    1. Anonymous

      I have the same issue.

      Did you get it sorted?

      1. Try to install using the 64 bit Installer instead. See the feature request here:  CONF-26474 - Linux Installer should check the architecture of the machine Resolved

  10. Anonymous

    If I install confluence in 'evaluation' mode and need to start over to install in 'Production' mode, what's the preferred method? Is there a dbconfig.xml file (similar to JIRA) that can be deleted so I can start over?

    1. Anonymous

      Appears renaming or deleting the confluence.cfg.xml file will allow you to start over.

  11. Anonymous

    I installed the evaluation version of confluence. It is accessible via a web browser but what is the initial username and password to log in? Do I have to set up the database first or do I connect confluence with my database in the administration section of the web GUI? For this I have to be able to log in first, right?

    1. Hi there! The username and password would depend on what you set up in the User Management step of the installation wizard. If you chose to connect to JIRA, any user account from JIRA that has access to Confluence should let you log in. If you chose to manage users within Confluence, the next step of the wizard should have asked you to create a user by entering a username and password.

      If that didn't happen for some reason you can either delete the contents of your Confluence Home (Data) directory and start Confluence again to restart the setup wizard (NB: this will delete any data in your instance, but if you haven't logged in yet that shouldn't be a problem), or you can run some SQL queries if you use an external database, to Recover Admin User Rights. If you'd like a hand with any of that feel free to raise a ticket at https://support.atlassian.com!

      - Denise

      Atlassian Support - Sydney 

  12. Anonymous

    Can Atlassian Confluence 4.3.7 be installed on RHEL 6? In support page it says OS - Linux or Solaris , have any one tried this on RedHat 6. Please help.

    1. RedHat Enterprise Linux (RHEL) 6 is a Linux distribution. Have you tried using the Linux installer?

  13. Anyone migrated from 3.5(.13) to 5.3(.1) ?

    1. You need to do migrate first on 4.0 and then you should be able to go to 5.3.

      1. Hi Anil and Steve,

        Generally we recommend going through each major version when upgrading, but you can often skip some without any problems (but restore your backups and go through each major version if you do hit any). The caveat there is that you must go from 3.5.x to something in between 4.0-5.0 (inclusive), before proceeding to 5.1 and higher.

        Additionally, if you have file system links, we recommend going from 3.5.x directly to 5.0.3, because of this issue, then proceeding to 5.3 or above.

        As always, back everything up before starting, and run it on a test instance first, to come up with a robust upgrade plan for your instance. And give Support a shout if you run into any problems or have any questions (smile)

        -Denise (Support).

  14. I tried to update the Confluence server to be able to export a backup and restore it on the OnDemand Confluence version, but the server falied to work.

    Now i downgraded to the old version and i am getting this error:

    Cause

    com.atlassian.util.concurrent.LazyReference$InitializationException: java.lang.NullPointerException
        at com.atlassian.util.concurrent.LazyReference.getInterruptibly(LazyReference.java:152)

    caused by: java.lang.NullPointerException
        at com.atlassian.spring.container.ContainerManager.getComponent(ContainerManager.java:33)

    Stack Trace:[hide]

    com.atlassian.util.concurrent.LazyReference$InitializationException: java.lang.NullPointerException
    	at com.atlassian.util.concurrent.LazyReference.getInterruptibly(LazyReference.java:152)
    	at com.atlassian.util.concurrent.LazyReference.get(LazyReference.java:115)
    	.....

     

     

    Do anyone has any idea on why this is failing ?

    1. Hi Bruno,

      A NullPointer like that indicates that there was another error that occurred earlier in the process. We'd need to get a look at your full logs to figure out what happened there, so I'd recommend raising a support ticket at https://support.atlassian.com, upload a Support Zip to it, and the team will be in touch!

      -Denise.

      1. Hi Denise,

        What I did was reinstalling the old version from scratch and copy the attachments and the db dump and it worked again on my own hosted version, so I am in the same place i was before upgrading. Now the problem is different, I didn't find any place to import a complete backup on the OnDemand version, although the documentation says it is supported. So I tried to import space by space, I installed confluence 4.2.6 on another server, and import the backed up xml data, and then upgrade to the latest version, which worked, but the spaces links are linked back to the original confluence installation (on the original server), so I couldn't create updated backup versions of the spaces to import space by space on the OnDemand confluence installation.

        So basically I tried different things, and nothing seems to work.

        I am running version 4.2.6 on my hosted version. Which would be the best way to import the data from the hosted version to the ondemand version ?

        1. Hi Bruno,

          Actually full imports are only supported if your OnDemand instance is Confluence only, no other products, so that may explain why the option isn't available. I had a chat to the OnDemand support team and they said that based on your comments about the problems you're having, they'd like you to file a support request and they can give you a hand with it (smile)

          Hope this helps!

          -Denise

          1. Hi Denise,

            Should i wait for them to contact me ?

            Thanks,

            Bruno

            1. Hi Bruno, we've just responded in the ticket, you should have an email from me with the latest update. Let's talk there (smile)

              -Denise.

        2. Bruno, I am adding this comments to the support ticket thread, it has been moved to OnDemand team and they should be able to assist you during this import task. 

  15. So when would you use the "Standalone" download?  It is not clearly stated what the difference is between the "Confluence Installer" and the "Confluence Standalone" downloads.

    A little guidance on the download page would be most welcome and appreciated.