• Document Up to Date

Quick Start Guide

This section describes how to quickly install CrafterCMS and start crafting your experiences. The steps listed below is intended to help the user start using CrafterCMS for development or evaluation only.

To setup CrafterCMS:

  • Install from prebuilt binaries download


    For Windows Users
    Windows users needs to install Windows Subsystem for Linux (WSL) by following the instructions here which will enable the required optional components, download the latest Linux kernel, set WSL 2 as your default, and install Ubuntu Linux for you.

    All commands below needs to be executed in a WSL 2 terminal. Also, all items that needs to be downloaded and installed needs to be in WSL 2.

    Quick start - WSL 2 Ubuntu terminal :width: 70 % :align: center

    See here for more information on WSL.

    All the steps below applies to installing CrafterCMS via the WSL terminal. See here for detailed instructions on installing CrafterCMS on Windows via WSL

    CrafterCMS may also be run via Docker. Note that the preferred method of installing and running CrafterCMS is via the binary archive through WSL 2 as described here.

Installing CrafterCMS from Prebuilt Binaries

Here are the steps to start using CrafterCMS for development or evaluation by installing CrafterCMS from the binary archive download:

  1. Download and install Java 8

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

    Make sure that you have a JAVA_HOME environment variable that points to the root of the JDK install directory. See here for more information on the JAVA_HOME environment variable

  2. Download CrafterCMS binaries

    Download the CrafterCMS install binary archive from https://craftercms.org/downloads

    Select crafter-cms-authoring-VERSION.tar.gz. The .tar.gz file will install a fully functional authoring instance. Out of the box, the authoring instance uses a local directory as the repository and an embedded database, which allows a quick and easy set up for local development.

  3. Extract the CrafterCMS binaries

    Extract the contents in any directory.

    tar -zxvf crafter-cms-authoring-VERSION.tar.gz -C /tmp/extract_to_some_directory/

    The extracted files should look like this:


  4. Start CrafterCMS

    To start CrafterCMS:

    From the command line, navigate to the {Crafter-CMS-unzip-directory}/crafter/bin/ directory, and execute the startup script:



    It takes a few seconds for CrafterCMS to startup and takes longer to startup the very first time you startup CrafterCMS.

    To stop CrafterCMS:

    From the command line, navigate to the {Crafter-CMS-unzip-directory}/crafter/bin/ directory, and execute the shutdown script:


  5. Access Crafter Studio

    In your browser, go to


    • Login with the following:

      • username: admin

      • password: admin

    After logging in, you should be redirected to the Sites screen, and you’re now ready to create your first experience!