Specifying your Crowd Home Directory

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

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 crowd-init.properties file. This is found at <crowd_install_directory>/crowd-webapp/WEB-INF/classes/crowd-init.properties
  • 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:

      crowd.home=c:/data/crowd-home
      

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

    • On Mac and UNIX-based systems:

      crowd.home=/var/crowd-home
      

      Important

      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 crowd-init.properties file.

Advanced Usage

It is also possible to define the crowd.home property as a Java system or Servlet Context parameter.

Java System Parameter

Use the following format for your Java parameter:

-Dcrowd.home=/var/crowd-home
Where should you put this value?

You could add it to the setenv.sh or setenv.bat file supplied with the Crowd distribution (not Crowd EAR-WAR).

Servlet Context Parameter

The following configuration XML can be added to the crowd-standalone-install/apache-tomcat/conf/Catalina/localhost/crowd.xml context file
to set the crowd.home property:

   <Parameter name="crowd.home" value="/var/crowd-home" override="false"/>        
Last modified on May 17, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.