System Administrators

This guide is intended to provide system administrators with the information and access to the tools they need to install and maintain Crafter CMS components.

System Requirements

Parameter Name
Crafter Studio

Content authoring server

Java 1.8+
4+ Gig of memory to JVM
Crafter Engine

Content delivery server

Java 1.8+
2+ Gig of memory to JVM
Crafter Profile

User profile and attribute store
(Optional component)

Java 1.8+
MongoDB 3+ (included in the bundle)
1+ Gig of memory to JVM
Crafter Social

User Generated Content server
(Optional component)

Java 1.8+
MongoDB 3+ (included in the bundle)
1+ Gig of memory to JVM


Crafter CMS is not yet compatible with Java 1.9. We are working on updating our code to make sure we are 100% compatible with the newest Java version.

Installing and verifying prerequisites

Install Java

Download and install Java JDK 1.8 (either Oracle or OpenJDK).

Verify Java Version

Ensure that you are running Java 1.8. To check, run the following command at the command prompt and make sure that the version displayed is Java 1.8:

java -version

The command above should output something like this:

java version "1.8.0_91"

Verify JAVA_HOME environment variable is set correctly

Make sure that you have a JAVA_HOME environment variable that points to the root of the JDK install directory. To check the value set for JAVA_HOME, enter the following command at the command prompt:

For Unix/Linux Systems:

env | grep JAVA_HOME

For Windows Systems:


How to set the JAVA_HOME environment variable

To set JAVA_HOME on a Unix/Linux System

  • Korn and bash shells:

    export JAVA_HOME=jdk-install-dir
    export PATH=$JAVA_HOME/bin:$PATH
  • Bourne shell:

    export JAVA_HOME
    export PATH
  • C shell:

    setenv JAVA_HOME jdk-install-dir
    setenv PATH $JAVA_HOME/bin:$PATH
    export PATH=$JAVA_HOME/bin:$PATH

To set JAVA_HOME on a Windows System

  • Do one of the following:
    • Windows 7 – Right click My Computer and select Properties > Advanced
    • Windows 10 - Type advanced system settings in the search box (beside the Windows start button) and click on the match
  • Click the Environment Variables button
  • Under System Variables, click New
  • In the Variable Name field, enter: JAVA_HOME
  • In the Variable Value field, enter your JDK installation path
  • Click on OK and Apply Changes as prompted


For Windows users, the path specified in your JAVA_HOME variable should not contain spaces. If the path contains spaces, use the shortened path name. For example, C:\Progra~1\Java\jdk1.8.0_91


For Windows users on 64-bit systems:

  • Progra~1 = Program Files
  • Progra~2 = Program Files(x86)


Windows users using older operating systems may experience issues when Crafter CMS starts up MongoDB and see the following error:

The program can’t start because api-ms-win-crt-runtime-l1-1-0.dll is missing from your computer. Try reinstalling the program to fix this problem.

For MongoDB to startup properly, a Microsoft update may be needed for older operating systems including:

  • Windows 7
  • Windows Server 2012 R2
  • Windows Server 2012

To install the update, download the Universal C Runtime update from Microsoft ( ) When the update is installed, please try to start Crafter CMS again.

OS X extra prerequisite

For OS X users, the latest openssl formula needs to be installed via homebrew:

brew install openssl

Linux prerequisite

For Linux users, some of the scripts uses lsof. Please note that some Linux distributions does not come with lsof pre-installed and so, may need to be installed.

To install lsof for Debian-based Linux distros: apt-get install lsof

To install lsof for RedHat-based Linux distros: yum install lsof

To Install a Development Environment

To install a development environment, see the section on installing Crafter CMS from the zip download or the section on installing Crafter CMS from archive built by the Gradle environment builder in the Quick Start Guide.

To learn more about the developer workflow, see Introduction to the Developer Workflow with Crafter CMS.

Crafter Commons