This documentation relates to Crowd 2.4.
If you are using an earlier version, please view the previous versions of the Crowd documentation and select the relevant version.
Skip to end of metadata
Comment: Corrected a typo and changed default locations
Go to start of metadata

This page contains some useful information about running Crowd under Linux/UNIX:

  • Dedicated system user. For security reasons, and to keep your system administrator happy, you should probably create a dedicated non-root user to run Crowd.
  • Automatic startup. It is useful to set up Crowd to run automatically on UNIX startup.

Running Crowd as an Unprivileged User

Here is an example of some of the changes you can make to harden up the directory and file permissions for Crowd to run as a non-root user.

You will need to update the environment variables to suit your installation. This is also for use in BASH. If you are using a different shell, you might need to tweak some things.

Getting Crowd to Start Automatically

  1. Create an init.d file (for example, 'crowd.init.d') inside your {CROWD_INSTALL} directory:

  2. Create a symbolic link from /etc/init.d/crowd to the init.d file file.
Hint for Red Hat systems

On Red Hat and Red Hat-based systems such as CentOS, if you put the above script in /etc/init.d, you can create the necessary symbolic links with the chkconfig script, since all the rrequired information is in the script header.

Replace "SCRIPT_NAME" with whatever the real name of the script is.

Thank you for this information

Thank you to Matthew Block and Pete Toscano for the original comments that we based this information on.

Labels:
None
Edit Labels

7 Comments

Hide/Show Comments

  1. Mar 25, 2010

    Daniel Harvey

    Recent versions of Ubuntu are using upstart in place of the older System-V init.

    Here is my /etc/init/crowd.conf in case you're interested:

    Note: The "start on" semantic which ensures that Crowd is started before Jira or Confluence (add other apps is you have them installed (smile) )

    1. Jul 28, 2010

      Anonymous

      Harvey, I  just wanted to thank you for taking the time and sharing your Ubuntu start scripts.  I'm using Karmic and I'm sure it would have taken me quite a while to figure out exactly what I needed to do to get things to start at boot time.  Kudos.

    2. Sep 29, 2010

      Anonymous

      Is there a way to merge this with the traditional /etc/init.d/ scripts? I'd like to add a 'start on' condition for postgres to ensure that crowd is not started until my database is up and running.

    3. Mar 31, 2011

      steve brice

      How would I do this for a full sweet of Atlassian products? I just built an Ubuntu 10.10 server, running "Jira, Crowd, Confluence, Fecru, Bamboo." My dept. would like to have an automatic startup script in case the server goes down.

  2. Oct 28, 2010

    Tiemco de Jong

    Hi, we chose to keep RUN_AS_USER at root.

    However when I do a /etc/init.d/crowd stop, the java instance with crowd keeps running. So when I do a crowd restart, I get two instances.
    Any suggestions why shutdown.sh won't work?

  3. Nov 22, 2010

    Anonymous

    if you want to use update-rc.d (debian lenny) then you have to change the first block in the script to the following:

  4. May 27, 2011

    John Murdoch

    Use the linked rc.d script to start / stop crowd running on FreeBSD. http://confluence.atlassian.com/display/CROWD/Supported+Platforms?focusedCommentId=240915151#comment-240915151