Installing Confluence on Linux

This guide describes how to install a new Confluence installation on Linux using the installer. You can also install manually from a zip archive - see Installing Confluence on Linux from Archive File for details.

 If you are upgrading Confluence, please see Upgrading Confluence.

Before you Start

Ensure that your system meets the minimum requirements to run Confluence. See System RequirementsSupported Platforms and be sure to check the Database Configuration documentation for any specific requirements related to your chosen database.

On this page:

(warning) 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.

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:

  • (to start Confluence)
  • (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>


  • <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


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

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

46 Archived comments

  1. User avatar

    Edwin Dawson [Atlassian Technical Writer]

    For support and troubleshooting help, please open a support request at, where our support engineers will be able to get back to you quickly.

    Best Regards,

    Edwin Dawson
    Technical Writing Team Leader

    13 Sep 2011
  2. User avatar


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

    15 Sep 2011
    1. User avatar

      Edwin Dawson [Atlassian Technical Writer]

      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

      15 Sep 2011
  3. User avatar

    Matthew Cornell

    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.

    27 Oct 2011
  4. User avatar

    Matthew Cornell

    'Installation directory' = 'Destination Directory'?

    27 Oct 2011
  5. User avatar


    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.


    23 Mar 2012
  6. User avatar


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

    08 May 2012
  7. User avatar


    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".

    25 May 2012
  8. User avatar


    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.


    14 Aug 2012
    1. User avatar


      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)

      14 Aug 2012
      1. User avatar

        gabi nastase

        atlassian-confluence-5.6.3-x64.bin. It's October 2014 and this is still here (sad)

        Your solution worked. (smile)

        08 Oct 2014
  9. User avatar


    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

    27 Aug 2012
    1. User avatar


      I have the same issue.

      Did you get it sorted?

      12 Mar 2013
    1. User avatar

      Carlos Eduardo

      same here too

      22 Mar 2013
      1. User avatar

        Amalia Sanusi [Atlassian]

        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

        14 Apr 2013
  10. User avatar


    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?

    18 Oct 2012
    1. User avatar


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

      18 Oct 2012
  11. User avatar


    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?

    06 Jun 2013
    1. User avatar

      Denise Unterwurzacher [Atlassian]

      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!

      - Denise

      Atlassian Support - Sydney 

      11 Jun 2013
  12. User avatar


    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.

    04 Sep 2013
    1. User avatar

      Martijn Heemels

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

      06 Sep 2013
  13. User avatar

    Anil Samuel

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

    08 Nov 2013
    1. User avatar

      Steve Gerstner [bridgingIT]

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

      08 Nov 2013
      1. User avatar

        Denise Unterwurzacher [Atlassian]

        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).

        08 Nov 2013
  14. User avatar

    Bruno Sampietro

    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:


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

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

    Stack Trace:[hide]

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



    Do anyone has any idea on why this is failing ?

    22 Nov 2013
    1. User avatar

      Denise Unterwurzacher [Atlassian]

      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, upload a Support Zip to it, and the team will be in touch!


      25 Nov 2013
      1. User avatar

        Bruno Sampietro

        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 ?

        25 Nov 2013
        1. User avatar

          Denise Unterwurzacher [Atlassian]

          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!


          25 Nov 2013
          1. User avatar

            Bruno Sampietro

            Hi Denise,

            Should i wait for them to contact me ?



            26 Nov 2013
            1. User avatar

              Denise Unterwurzacher [Atlassian]

              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)


              26 Nov 2013
        1. User avatar

          Guilherme Nedel [Atlassian]

          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. 

          25 Nov 2013
  15. User avatar

    Michael Brinson

    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.

    03 May 2014
  16. User avatar

    shawn spaeny

    Server startup logs are located in /opt/atlassian/confluence/logs/catalina.out

    Using CATALINA_BASE: /opt/atlassian/confluence
    Using CATALINA_HOME: /opt/atlassian/confluence
    Using CATALINA_TMPDIR: /opt/atlassian/confluence/temp
    Using JRE_HOME: /opt/atlassian/confluence/jre/
    Using CLASSPATH: /opt/atlassian/confluence/bin/bootstrap.jar:/opt/atlassian/confluence/bin/tomcat-juli.jar
    Using CATALINA_PID: /opt/atlassian/confluence/work/
    Existing PID file found during start.
    Tomcat appears to still be running with PID 12694. Start aborted.


    This is what i get after trying to start confluence. I used the express install on Cent OS7. Help!!

    28 Aug 2014
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Shawn, sounds like Confluence is finding an existing PID file, I've heard this can happen when Tomcat was not previously shut down properly.   You could try removing the file manually, or contact Support and they'll guide you through what to do. 

      28 Aug 2014
    1. User avatar

      Guilherme Nedel [Atlassian]

      As Rachel mentioned, you may use "ps aux | grep java" to find the PID, and "kill -9 <PID>" to stop the process.

      28 Aug 2014
  17. User avatar

    shawn spaeny

    Thanks for the info I have removed the stale PID and everything seems to look ok in the catalina.out file. Only other problem now is i cant access using port 8090. 

    28 Aug 2014
    1. User avatar

      Denise Unterwurzacher [Atlassian]

      Hi Shawn, in that case it's probably time to contact Support - we can help you troubleshoot in depth (smile)

      28 Aug 2014
  18. User avatar

    Renato Rudnicki

    Hello Shawn, 

    I agree with Denise, maybe contacting the Atlassian Support might help you to solve the situation quickly. However, if you cannot access confluence on port 8090, make sure that the port 8090 is listening. You can check it with the command:

    netstat -vant |grep -i listen

    If you don`t see any port 8090 listening, maybe your confluence might be running in another port. You can check in what port confluence is set up verifying the server.xml on confluence_install/conf.

    I hope it helps (smile)




    29 Aug 2014
  19. User avatar


    Hi all

    I have problems with the Linux installation:

    Unpacking JRE ...
    Starting Installer ...
    Nov 25, 2014 3:51:39 PM java.util.prefs.FileSystemPreferences$2 run
    INFO: Created system preferences directory in java.home.
    Could not display the GUI. This application needs access to an X Server.
    You can also run this application in console mode without
    access to an X server by passing the argument -c

    Now if I add a -c "./atlassian-confluence-5.6.4-x32.bin -c" it brings the same error message.

    What's wrong?




    25 Nov 2014
  20. User avatar

    Jean-Claude De Giorgi

    Hi all,


    I don't know for you, but the installation of Confluence is a real pain.

    Keep having problem to connect to the DB (MySQL) while configuring the DB connection via the Confluence setup wizard.

    What do I have to choose? Direct JDBC or Datasource (by the way, I don't know what it means).

    I chose datasource because I just followed the documentation about configuring datasource.

    I get this kind of error:

    The following error(s) occurred:

    Could not lookup datasource successfully: com.atlassian.config.bootstrap.BootstrapException: Couldn't open a connection on Datasource (java:comp/env/jdbc/confluence):

    Setting up datasource database instance failed.


    It says for "Setup Datasource Connection":

    If “java:comp/env/jdbc/DataSourceName” doesn't work, try “jdbc/DataSourceName” (or vice versa)

    "DataSourceName" is the confluence database name (confluence in my case)?


    I think I should ask the support... .

    If anyone has an idea or installation procedure, you are welcome.

    Official documentation lacks many details.





    19 Dec 2014
  21. User avatar

    Jonathan Moore


    I'm using Confluence (and JIRA) running on a small notebook as a standalone solution. Both are installed in Ubuntu 14.04. For 2 uses at home, for occasional usage, this works very well.

    My question is, is there an upgrade guide for this situation ? I notice there is an upgrade option when running the .bin installation file, but what happens if I do this ? My database backup fits on an SD card, and Confluence/JIRA "up time" isn't an issue for me. I want an easy start and forget upgrade process (or as near as possible). It doesn't matter if my setup is down during this time.

    If I select the upgrade option during install, what will exactly happen ? Will I have to manually update config files (I have them backed up too) afterwards ? What will the upgrade option not do, that I need to do myself.

    Getting Confluence and JIRA setup, and playing together with secure connections took quite a long time, so I'm reluctant to upgrade until I know what this option involves. I wasn't going to use secure connections for use on a home server (this wasn't really required), but I had to do this when I placed an Excel spreadsheet in Confluence, and I wanted to edit it ! I can't remember which version of Confluence and JIRA I've installed, but this was during December 2014, so they are relatively new versions.

    Thanks, and although Confluence and JIRA wasn't easy to setup on my home server, they are really great tools.

    09 Mar 2015
    1. User avatar

      Rachel Robins [Atlassian Tech Writer]

      Hi Jonathan, you'll find more info about upgrading on these pages Upgrading Confluence (using the installer) and Upgrading Confluence Manually. It sounds like upgrading manually would probably work best for you. 

      All the info is on these pages, and you will need to manually update some config files (in some cases you may be able to copy your backed up files right in, but I would check to see if there are other changes in the file first - especially in the /  setenv.bat file). We recommend taking a full backup before you start too. 

      You should also read the upgrade notes for all versions between your current version and the one you plan to upgrade to.  If you have any problems, or have more detailed questions, feel free to contact Support directly for assistance. 

      09 Mar 2015
      1. User avatar

        Jonathan Moore

        Thank you. This info has helped a lot. It has given me enough confidence to perform an upgrade, which I'll do next month.

        10 Mar 2015
  22. User avatar

    Jon Cruz

    Confluence 5.8.6 (and 5.7.5) on a RHE, Scientific Linux, and Ubuntu 14.x machines... can't get this to install.

    I've tried both the installer and archive methods.  Nope.  

    I've tried installing as root and not as root.  Nope.

    I've tried changing the permissions of the folders within the "application-data" folder structure.  Still no luck.

    About to give up and decided I'd try this "comment" section.

    Error is always something to do with "bundle139" and "bundle140".   (Dr. Google doesn't have much to say on those two...)  And I already verified that those "bundle" files/folders aren't there.   (Not sure what generates those.)

    Anyone see this before?


    ERROR: org.apache.felix.framework.cache.BundleArchive: Unable to cache bundle info - /var/atlassian/application-data/confluence/plugins-osgi-cache/felix/felix-cache/bundle139/ (No such file or directory)

    ERROR: org.apache.felix.framework.cache.BundleArchive: Unable to cache bundle info - /var/atlassian/application-data/confluence/plugins-osgi-cache/felix/felix-cache/bundle140/ (No such file or directory)

    and usually followed by

    Caused by: java.lang.IllegalStateException: The com.atlassian.bandana.BandanaPersister Cache is not alive (STATUS_SHUTDOWN)


    UPDATE:  You can add an AWS EC2 Ubuntu machine to that list of Nopes above.  This time Bundle216.    

    ERROR: org.apache.felix.framework.cache.BundleArchive: Unable to cache bundle info - /opt/atlassian/application-data/confluence/plugins-osgi-cache/felix/felix-cache/bundle216/ (No such file or directory)



    30 Jul 2015
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      Hi Jon,

      Might be better to contact support about this one, or ask it over at answers. I doubt it'll get the eyes it needs to, here.

      31 Jul 2015
      1. User avatar

        Jon Cruz

        I did just that.  

        Funny thing, I got it to run on Windows, (but would prefer the Linux install).

        Thanks Giles.


        03 Aug 2015
Powered by Confluence and Scroll Viewport