Documentation for Crowd 2.8. Documentation for earlier versions of Crowd is available too.

Skip to end of metadata
Go to start of metadata

The instructions below tell you how to install the Crowd distribution (not EAR-WAR), which includes Apache Tomcat. If you wish to deploy a WAR distribution of Crowd or CrowdID on your own existing application server instead, read the instructions on the Crowd WAR distribution.

Crowd versions 1.1 and later include CrowdID. Installing Crowd, as described below, will also install CrowdID.

Hint: If you are evaluating Crowd or you are unsure which version to install, just follow the simple instructions on this page.


On this page:

1. Prerequisites

  • Java. You will need to install a Java Development Kit (JDK) on your operating system before before proceeding with a Crowd installation. Please note that Crowd requires the full installation of a JDK. It is not enough to run Crowd on a Java Runtime Environment (JRE) alone. For instructions on installing the Sun JDK and setting JAVA_HOME, please refer to Supported Platforms.

2. Install Crowd

  1. Download Crowd (not the EAR-WAR distribution).
  2. Please check your unzip program before extracting the downloaded archive – see the note on the Crowd installation front page.
  3. Unzip the download archive into a directory of your choice. Note: Do not specify directory names that contain spaces.
    (info) We'll refer to this installation directory as {CROWD_INSTALL}.

  4. Specify your Crowd Home directory by editing the configuration file at: {CROWD_INSTALL}\crowd-webapp\WEB-INF\classes\ The Crowd Home directory is where Crowd will store its configuration information. If you are using the embedded HSQL database, supplied for evaluation purposes, Crowd will also store its database in this directory. (Note however that the CrowdID database will be in the installation directory, not the Home directory.) To specify the Crowd Home directory:
    • Open the file. This is found at <crowd_install_directory>/crowd-webapp/WEB-INF/classes/
    • Choose the appropriate line in the file, depending upon your operating system (see below).
    • Remove the # at the beginning of the line.
    • Enter the name of the directory you want Crowd to use as its Home directory. For example,
      • On Windows:

        Note: On Windows, make sure you use forward slashes as shown above, not backward slashes.

      • On Mac and UNIX-based systems:


        Please, ensure that the Crowd Home directory will not match the Crowd installation directory AND it is writable by the user executing the initialization script.

    • Save the file.

3. Prepare your Database

For evaluators

This step applies to production installations. If you are evaluating Crowd and are happy to use the database supplied, you can skip this step.

If you wish to set up Crowd and/or CrowdID with an external database, see:

4. Start Crowd and Complete the Setup Wizard

  1. Run the start-up script, found in your {CROWD_INSTALL} directory:
    • start_crowd.bat for Windows.
    • for Mac and Unix-based systems.
  2. Point a web browser at http://localhost:8095/crowd where you will see the Crowd Setup Wizard. Follow the instructions in the Wizard. You can also read more information about the Setup Wizard.

Next Steps



  1. Anonymous

    on your operating system before before proceeding with a Crowd installation

  2. Would be more useful if the instruction we broken up cleanly by operating system.

    Also how do you handle the situation when '' does not run?

  3. Hello everyone!
    I have some problem with 'start_crowd.bat'. I follow documentation, but Crowd not started. I use command panel with admin rules and write 'netstat -a', but i'm not looking '' or anyone service who listening '8095' port. 
    What's may be wrong? 

  4. I too had the same issue today when trying to install Crowd - I needed to setup the JAVA_HOME Environment Variable before the batch file would run.

    Setting JAVA_HOME 

  5. Because you have a period in the crowd.home variable, this has to be set in the manually every upgrade. If you removed the period - say CROWD_HOME to be like JAVA_HOME - this could be set as an environmental variable and make Linux upgrades simpler and abit more fool-proof. 


  6. The sequence of the described steps is not completely correct. I just followed the instructions and detected that the "Next Steps - run automatically..." instructions require that the previous step "4. Start Crowd..." has not yet been performed. This leads to a failure of the "mkdir" command in the preparations script of "Next Steps", because the database folder has already been created and filled by the previous step.

  7. APA

    When installing Confluence you the installation process creates a Directory "C:\Program Files\Atlassian\Application Data\Confluence" where the application data. Now with Crowd installation you require that the path should not contain spaces. I don't want to have all application data directories spread all over the machine. Could you kindly invest a bit in having a consistant approach for keeping application data for all Atlassian products ?

  8. I am installing on Linux, and does not have a browser. After starting the crowd, how to browse from a windows machine? the localhost:8095 does not work...

    1. You would go against the linux machine's IP address, not "localhost". Localhost literally means the computer you are on. 

      e.g. "". 

      8095 is the default port unless you changed it during the install; if you are in doubt of the port, you can check the apache-tomcat/conf/server.xml file, it defines the http & https ports.  

  9. Thanks Kelly,


    DO i need to update this server.xml to the IP instead of local host?


    Also look like some of the instructions for linux install above are missing. Afer unzipping the Tar to crowd install directory  and before starting the corwd using, do we need to make any configuration chages? 

    though my tomcat is started successfully, i am unable to browse "".  I don't get any error, it simply says This webpage is not available.

    1. No, you normally would not update the server.xml to an IP, it's normally a self-referential file. 

      You don't need to make config changes before you start Crowd up for the first time; you may want to make some small changes later on when you've decided on certain values, like DNS names and how large you want to size your install (memory settings). Initially, don't worry about it. 

      Edit: The exception is the file in step #2 at the top of this page. You do need to set your home directory. 

      When I said that was just a made-up IP. (192.168.* is a reserved block for internal use; it's a complete guess you may be using it) You will need to ascertain the IP address of your Linux machine/vm and use that IP, port 8095. If you're at the command prompt of the Linux machine, "ifconfig" can help you out on most distributions. 

      This isn't too hard to setup, but you may want to consider hiring an IT person to set this up in the most secure, robust manner possible. 


  10. Yes, i am using the Linux IP which starts with 10. x.x.x. I have done this before  successfully on windows. But somehow on the linux installation it is not coming up.

    I did setup the home directory, however changed the default home directory from /var/crowd-home to home/crowd-home and then executed the

    I get a message that tomcat started successfully, but when i browse the ip with port, it simply says, page not available.

    1. You may want to open a support ticket, we're using a public page to troubleshoot your issues and our signal to noise ratio isn't so great. I'm sure everyone else watching this page is totally enthralled with us (wink)

      Check to make sure it's still running (ps -ef) and not exiting soon after you start it. More importantly, check the contents of the atlassian-crowd.log file in your crowd home directory/logs. If there are errors occurring preventing tomcat from running, they will be there. 


  11. Hi Kelly,

    I agree with you, Thanks a lot for the help and lets stop it here.


    Sorry folks for the noise. Take it easy please.