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+
1+ Gig of memory to JVM
Crafter Engine

Content delivery server

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

User profile and attribute store
(Optional component)

Java 1.8+
MongoDb 3+
1+ Gig of memory to JVM
Crafter Social

User Generated Content server
(Optional component)

Java 1.8+
MongoDb 3+
1+ Gig of memory to JVM

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 8 – Go to Control Panel > System > Advanced System Settings
    • 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)

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.