This page last changed on Oct 17, 2006 by david.soul@atlassian.com.

Reasons For Hosting Confluence As A Service

If you are hosting Confluence on a Windows-based server, installation as a Windows Service offers these advantages:

  • Automated Confluence recovery after server restart
  • Improved troubleshooting through logging server output to file

The guide below applies only to versions of Confluence earlier than version 2.2.0. Users of 2.2.0 or newer should use the Start Confluence automatically on Windows as a Service guide.

Installing Confluence Standalone As A Service

From your Windows-based server running Confluence 1.5 or earlier:

  1. Open a DOS prompt
  2. Set the CATALINA_HOME variable to the Confluence Standalone root directory (that containing the bin and confluence director):
    C:\> set CATALINA_HOME=c:\progra~1\confluence-1.3.5-standalone

    If a directory in the path has spaces (eg. 'C:\Program Files\..'), please convert it to its eight-character equivalent.

  3. Ensure the JAVA_HOME variable is set to the JDK base directory, with echo %JAVA_HOME%.
  4. Run the following command, all on one line (or download it):
    "%CATALINA_HOME%\bin\tomcat.exe" -install Confluence
    "%JAVA_HOME%\jre\bin\server\jvm.dll"
    -Djava.class.path="%CATALINA_HOME%\bin\bootstrap.jar;%JAVA_HOME%\lib\tools.jar"
    -Dcatalina.home="%CATALINA_HOME%" -Xms128m -Xmx256m
    -start org.apache.catalina.startup.BootstrapService
    -params start -stop org.apache.catalina.startup.BootstrapService -params stop -out
    "%CATALINA_HOME%\logs\stdout.log" -err "%CATALINA_HOME%\logs\stderr.log"

    Once you've run this command successfully, you can start Confluence by running the following command

    C:\> net start Confluence

    Alternatively you can pull up the Windows Services page and start the service from there.

    You will need to ensure that the %CATALINA_HOME%*, index and database directories are all writeable by the user the service is running as.
    Confluence should now be installed as a service, but will not automatically start up until the next server reboot.

    The Confluence service can be uninstalled with:

    "%CATALINA_HOME%\bin\tomcat.exe" -uninstall Confluence

installservice.bat (application/octet-stream)
Document generated by Confluence on Aug 07, 2008 19:08