Documentation for Confluence 5.8 (Server).
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 Windows using the installer. You can also install Confluence manually from a 'zip' archive - see Installing Confluence on Windows from Zip File for details.

If you are upgrading Confluence, please refer to the Upgrading Confluence guide.

(warning) Note: Some anti-virus or other Internet security tools 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.

On this page:

Before you Start

  1. 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.
  2. Have your Confluence license key ready. You can obtain a trial, free or commercial license, or retrieve your existing license key at my.atlassian.com.

Using the Installation Wizard

Use the installation 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 Run the Confluence 'Windows Installer'

(tick) To install Confluence as a service, the Windows Installer must be run using a Windows administrator account. While you can run the Windows Installer with a non-administrator account, your installation options will be much more limited.

  1. Download the Confluence 'Windows Installer' (.exe) file from the Confluence Download page.
  2. Run the installer file to start the installation wizard.
    (info) If a Windows 7 (or Vista) 'User Account Control' dialog box requests if you want to allow the installation wizard to make changes to your computer, click 'Yes'. If you do not, the installation wizard will have restricted access to your operating system and any subsequent installation options will be limited.
  3. Choose between the 'Express Install' or 'Custom Install' options:
    1. Express Install — If you choose this option, Confluence will be installed with default settings which are shown in the next step of the installation wizard. If you want to customise any of these options, click the 'Back' button and choose the 'Custom Install' option instead.
    2. Custom Install — If you choose this option, Confluence will prompt you to specify the following options (which are presented during subsequent steps of the installation wizard and pre-populated with default values):
      • The 'Destination Directory' in which to install Confluence.
      • The Confluence Home and other important directories (which must be unique for each Confluence installation).
      • The Windows 'Start' menu folder options.
      • The TCP ports (i.e. an HTTP connector port and a control port) that Confluence will operate on.
      • If you are running the installer using an administrator account, you will be prompted to 'Install Confluence as a service' (recommended). You can also do this manually later, as described in Start Confluence Automatically on Windows as a Service.
        (tick) If you installed Confluence as a service, you must start Confluence through the Windows 'Start' menu, since Confluence will not start if you run start-confluence.bat at the Windows Command Prompt.
  4. The installation wizard will install Confluence onto your operating system and will start Confluence automatically when the wizard finishes. Confluence will also be launched automatically in your browser window if you chose this option.

(info) Please Note:

  • If you chose to install Confluence as a service, the Confluence service will be run as the Windows 'SYSTEM' user account. To change this user account, see Changing the Windows user that the Confluence service uses.
  • If you do not install Confluence as a service, then once started, Confluence will be run as the Windows user account under which Confluence was installed.
  • If you use Confluence running on a Windows Server in production, we strongly recommend creating a dedicated user account (e.g. with username 'confluence') for running Confluence.
    • For more information about creating a dedicated user account and defining which directories this account should have write access to, refer to our guidelines.
      (tick) If your Windows Server is operating under Microsoft Active Directory, ask your Active Directory administrator to create a dedicated user account that you can use to run Confluence (with no prior privileges).
    • If Confluence is installed as a service, do not forget to change the user account that runs the Confluence service to your dedicated user account for running Confluence.

2. Starting Confluence

If Confluence is not already started, you can start Confluence using the appropriate Windows 'Start' menu shortcut or command prompt option.

Once Confluence is started, you can access Confluence from the appropriate Windows 'Start' menu shortcut or a browser on any computer with network access to your Confluence server.

2.1 Windows 'Start' Menu Shortcuts

The Installer will have created the following Windows 'Start' menu shortcuts:

  • Access Confluence — opens a web browser window to access your Confluence application.
    (info) Your Confluence server must have been started for this shortcut to work.
  • Start Confluence Service — starts up the Apache Tomcat application server which runs your Confluence installation, so that you can access Confluence through your web browser.
  • Stop Confluence Service — stops the Apache Tomcat application server which runs your Confluence installation. You will not be able to access Confluence through your web browser after choosing this shortcut.
  • Uninstall Confluenceuninstalls Confluence from your Windows operating system.

2.2 Starting and Stopping Confluence from a Command Prompt

Enter the bin subdirectory of your Confluence installation directory and run the appropriate file:

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

(info) If you followed our guidelines for running Confluence with a dedicated user account, then to run Confluence as this user account (e.g. 'confluence'), use the runas command to execute start-confluence.bat. For example:

  • > runas /env /user:<DOMAIN>\confluence start-confluence.bat
    (where <DOMAIN> is your Windows domain or computer name.)

2.3 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 in your web browser, you may need to change the port that Confluence runs on.

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 installation wizard (above), you can use a configuration file from this Confluence installation (called response.varfile) to re-install '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=C\:\‌\Program Files\\Atlassian\‌\Confluence
    Unattended installations will fail if any relative directory paths have been specified in this file.

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

  1. Download the Confluence 'Windows Installer' (.exe) file from the Confluence Download Center to a suitable location.
  2. Open the Windows command prompt and perform the remaining steps in the command prompt.
  3. copy the response.varfile file located in the .install4j subdirectory of your previous Confluence installation directory, to the same location as the downloaded 'Windows 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 'Windows Installer' file and run the following command:

    atlassian-confluence-X.Y.exe -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 step 2 Starting Confluence (above).
  • No labels

15 Comments

  1. Anonymous

    These instructions are incomplete and idiotic. Half way through I am being asked to configure a database. Should I have already installed MySQL? How? Where? what is jdbc vs datasource? Where is all this information. you make it appear as if we just click a button and everything is there. Where are the prerequisites to the installation?

    1. Hi there, thanks for your feedback.

      The prerequisites are listed under System Requirements. I've added a link to this page.

       

      1. Anonymous

        Ouch anonymous! Edwin basically said 'rtfm'... apparently they don't understand the term 'customer service' at Atlassian.

        What he should have said was, "I'm so sorry you're having a problem, sir! I will be happy to help you resolve it right away. We here at Atlassian value our customers and want their experience to be easy and pleasant. Being a 'technical writer', I will make it my personal mission to clarify that muddled documentation (created by my predecessor of course...) immediately."

      2. I have updated the documentation on this page.

  2. E P

    I agree there should be a heading "Before you start", which makes it clear you need to have installed a database, Java (possibly) etc, before you run the installer.

  3. Anonymous

    I have a problem to logging in. the user name and password i have created in Atlassian site. they're not working in conluence login page. http://localhost:8090/dologin.action

    it keeps telling me this.. The following error(s) occurred:

    • Sorry, your username and password are incorrect. Please try again

    when i say forgot password: i get following

    Sorry, you can't retrieve your password as no email service has been configured for Confluence. Please contact your administrators for assistance.

    when i click administrator hyperlink: i get

    No mail server has been configured so it is not possible to contact the site administrators via this method.

    So whats going in here? i dont understand. any help appreciated.


    Thanks

  4. Anonymous

    The setup behaves differently depending on whether it is run under the Administrator or user account (even if you press Yes when the Account Control prompt comes up it is different from launching as Administrator from the start). For instance, the default installation folders are different (user folder vs Program Files). As far as I can see, to install Confluence in a production environment you MUST run the installer as Administrator. It is not obvious from the article at all. I recommend adding some clarification on the above at the top of the page.

  5. Hi,

    I just went through Confluence on Windows install process with an evaluation version of 4.1.9. Our goals are to make this instance available to a few users, upload and/or write a bit of documentation manually, but also test Quadralay WebWorks deployment of FrameMaker-to-Wiki output from our existing docset.

    You could make this initial procedure more user-friendly by adding a couple of tid-bits about  allowing access to the Confluence server behind the firewall and enabling the Remote API (XML-RPC & SOAP). Until we enabled the remote API, we could not connect to the Confluence URL from a browser on any other system except the local host and could not get a successful test or deployment of WebWorks output to the server. 

    Here are the steps I took after installing (when we finally figured them out). I included all the buzz words I Googled for here so maybe it will help someone else.

    Having trouble connecting to Confluence Wiki URL from remote machines or from WebWorks?

    • Try this: Log into Confluence as the Confluence Admin, go to Browse > Confluence Admin > General Configuration, and under Feature Settings check/enable Remote API (XML-RPC & SOAP), and click Save. Reboot the Confluence server (just for luck). This should solve both problems (i.e., provide access to your Confluence users via a browser and enable WebWorks deploy capability). (See Enabling the Remote API.)

    • Still stuck? Make sure that your firewall is not blocking Confluence executables in the bin directory. We actually found this more pertinent to install/deploy of an Apache web server on Windows, but it could impact your Confluence deployments too. For example,  to set this appropriately on a Windows 7 Firewall, go to Start menu > Control Panel > Allow a program or feature through Windows Firewall > Change Settings > Allow another program... > Browse. Go to the install dir (e.g., Atlassian/Confluence/bin/, select each tomcat executable (and any others), click Open and follow the prompts to add this to "Allowed programs and features". Click to enable (checkmark) the level of visibility you want (e.g., Domain, Private, or Public). 

    Enabling the Remote API is so fundamental, that a link to that info should be included on this page, along with links or a section on any other impacts to connectivity. The only hint you leave us with is your "Next Steps" which sends you to Confluence 101, with the assumption that getting connectivity was a snap. Getting connectivity for your user base is a typical stumbling block of setting up web or wiki servers, so anything you can do to highlight testing and next steps would be great at this point, perhaps as a fork here for those who need it.

    I hope this helps.–Thanks, Victoria

  6. I've just finished the setup by performing next-next-finish. Wizard asked me weather to start confluence. I said "let's do this!"

    Then?

    Firefox can't extablish a connection to the server at localhost:8090.

    Fail.

    Then I've started it by myself (smile)

  7. In the end, JDBC is easy.  But, the example URL for direct JDBC connection is vague.  If you have "localhost" anywhere in your URL connect string, I couldn't get it to work.  

    Server running Server2008 with a local MS SQL 2008R2 install:  In MS SQL Server Management Studio, your Server Instance name is at the top of the Object Explorer.

    example:  FARMSQL\ATLASDB (hostname and db instance)

    connect URL:  jdbc:jtds:sqlserver://FARMSQL:1433/confluence;instance=ATLASDB

    The rest should be straightforward.

  8. Anonymous

    I Installed confluence on windows without a hitch.

    it is accessible locally ok

    Now I need to connect to that installation remotely.

    the server already runs iis7 but I need more information on how to configure confluence to be accessible via a different url or port.

     

     

     

  9. Anonymous

    I downloaded & installed the trial version, logged in and played around with the software. Logged out, and now I can't log back in - password isn't recognized. I'm using the same password (which is the same as for my Atlassian ID, which works fine) so not sure what the problem is? I also get the error message about not being able to contact the Administrators because no email is setup. Very frustrating!

  10. Anonymous

    download 64-bit windows version, run installer, see error page:

    Confluence
    1. Install license
    2. Configure user management
    3. Setup is complete

    Set up step error

  11. This is all wrong.

     

    Once you manage to sort everything out by using third party forums you can get the Atlassian Confluence to start up into the configuration page but as soon as you enter the VALID registration key (for a migration from Linux) everything goes to hell and stops working, CPU usage goes to 60% solid forever on all 8 cores (Win7 64bit Pro, Core i7 at 3.4Ghz w/16Gb RAM) but no main/presentation pages ever appear onto the localhost browser and it eventually times out.

    Firewall is off, shouldn't affect a LOCAL HOST browser but I shut it off just in case.

    From then on, stopping the Confluence service doesn't work and can only be switched to MANUAL, then the PC rebooted in order to get a "semi-workable" PC to go into the config and try and get it back.

    I've tried with two different versions of MySQL (5.5 and 5.6.21) both are supposedly supported.

    This command from YOUR support page:

    GRANT ALL PRIVILEGES ON confluence.* TO confluenceadmin@localhost IDENTIFIED BY mypassword;

    Gives a SYNTAX ERROR. ?? Really ?? 

    Please have someone from your tech department buy a new Win7 PC and install Confluence on MySQL while documenting a proper how-to.

    It's a wonder anyone ever gets this working on new installations, when's the last time you sold a copy? Seriously.

     

  12. I tend to agree with many of the people here stating frustration with Atlassian installation procedures.  The only Atlassian product we use is Confluence.  We completely dumped JIRA because 1) it's just not that good, and 2) compared to JetBrains installers for their Java server products such as TeamCity, YouTrack, etc. the install process is a breeze with no hassle I have ever experienced.  Atlassian is not the same.  Almost every time I begin an installation of upgrade of an Atlassian product, I begin to stress out.

    Atlassian needs some serious work on the overall user experience of their installers. (Windows; I cannot speak for Linux).