Setting up a Crafter CMS production environment

This section lets you get started on setting up your Crafter CMS for production. A production environment normally consists of one authoring instance and one or more delivery instances.

Before we begin, please review the following for requirements and supported platforms: Requirements and Supported Platforms

Setting up the production environment

  1. We’ll first install the authoring instance. You can follow the Quick Start Guide to install and start authoring.

    Alternatively, you can also install craftercms and start authoring by cloning the craftercms repo and building and deploying it using gradle.

    git clone ./gradlew init build deploy -Penv=authoring ./gradlew start -Penv=authoring

  2. Create your site in authoring. You can follow the guide Your First Website to use one of the out-of-the-box blueprints provided by Crafter CMS.

  3. Now that you have a site setup in authoring, the next thing to do is to setup your site in the delivery instance(s). Let’s begin the delivery installation.

    Installing the delivery instance is almost the same as installing the authoring instance. The difference is, if you’re installing from a zip or archive built by the gradle environment builder, you need to download/use or crafter-cms-delivery-3.0.X.tar.gz. Follow the same steps used to install your authoring environment using the delivery zip files.

    If using the alternate way of installing craftercms, to install and start the delivery, simply run the following:

    git clone ./gradlew init build deploy -Penv=delivery ./gradlew start -Penv=delivery

  4. After starting delivery, we’ll setup the site we created in step 2 in our delivery instance. Crafter CMS comes with a script,, to help us setup our site for delivery.

    ./ [options] [site] [repo-path]

    See the guide Setup Site for a Delivery Environment for more information on setting up your site for delivery.

  5. For the rest of the delivery instances, you can just repeat the previous 2 steps for each one of them, or alternatively just duplicate the delivery installation directory for each instance.

  6. Your production environment is now ready.

For more information on using gradle, please see Crafter CMS.

Server Hardware Configuration Consideration

Crafter CMS performs multiple reads/writes to disk from various concerns such as the database, the repository, logs, etc. with very different I/O patterns. One of the primary factor for hardware bottlenecks is disk I/O.

For optimal performance, the server should have different storage systems (disks) mounted for different concerns, for example:

/dev/{dev0} -> /
/dev/{dev1} -> /opt/crafter/data/db
/dev/{dev2} -> /opt/crafter/data/repos
/dev/{dev3} -> /opt/crafter/data/indexes
/dev/{dev4} -> /opt/crafter/logs
/dev/{dev5} -> /opt/crafter/data/mongodb
/dev/{dev6} -> /var
/dev/{dev7} -> /home
/dev/{dev8} -> /usr

For more information on tuning your authoring environment for better performance, please see: Authoring Environment Performance Tuning