Written by The Jahia Team
   Estimated reading time:

This tutorial shows you how to get started from scratch with a local installation of Digital Experience Manager that runs in a Docker image.

At the end of this tutorial, you will have all you need to continue your learning experience, depending on what you want to learn next. You can follow links to further tutorials.

Installing Docker and running a DX Docker image

To make the installation as simple as possible, you use a Docker to deploy DX and its dependencies. If you don’t have Docker installed on your system, you can get it here: https://www.docker.com/get-started

To run a DX Docker image:

After installing Docker, open a Terminal window on Mac or a Command Prompt on Windows (cmd.exe) and type the following commands:

docker pull jahia/dx-dev:
docker run -p 8080:8080 jahia/dx-dev:

The initial startup of DX takes a few minutes. When DX finishes starting, you should see a message that looks like this:

 D E V E L O P M E N T   M O D E A C T I V E

 In development mode, Digital Experience Manager will allow JSPs to be modified, modules to be
 re-deployed and other modifications to happen immediately, but these DO have a performance impact.
 It is strongly recommended to switch to production mode when running performance tests or going live.
 The setting to change modes is called operatingMode in the jahia.properties configuration file.
     Started: 65
 Digital Experience Manager [Hit-Girl] - Enterprise Distribution - Build 59490.4480 is now ready. Initialization completed in 268 seconds

Logging into DX

You are now ready to connect to DX. Simply open a supported browser (see the Supported stack for a list of supported browsers) and enter the following URL:

The login page displays:


Login using the following default credentials:

Username: root
Password: root
Important: Docker images are not intended to be put in production as is. Exposing the images to the outside world without any further configuration could expose you to security issues.

Creating a web project

After successful login, the web project screen displays. The way you create a web project depends on what you want to achieve in these first steps.

Where to go from here

You have different options from this point on. You can try any of these topics and tutorials: