• 

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

  Note

  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.
  

  

  
  

  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:

   {Crafter-CMS-unzip-directory}
   |--crafter/
      |--LICENSE
      |--README.txt
      |--bin/
   

   
   

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:

   ./startup.sh
   

   
   

   Note

   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:

   ./shutdown.sh
   

   
   

5. Access Crafter Studio

   In your browser, go to

   http://localhost:8080/studio
   

   
   

   • 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!