First steps with Jahia

November 14, 2023

This tutorial shows you how to get started from scratch with a local installation of Jahia 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 Jahia Docker image

To make the installation as simple as possible, you use Docker to deploy Jahia and its dependencies. If you don’t have Docker installed on your system, you can get it here:

Note: To avoid connection issues, ensure that your Docker installation allows allocating up to 4GB of memory to a container. For MacOS users, in Docker go to Preferences>Advanced and set the memory limit to 4GB or more instead of the default 2GB.

To run a Jahia 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/jahia-dev:latest
docker run -p 8080:8080 jahia/jahia-dev:latest

The initial startup of Jahia takes a few minutes. When Jahia 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, Jahia 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 configuration file.
     Started: 65
 DX [Hit-Girl] - Enterprise Distribution - Build 59490.4480 is now ready. Initialization completed in 268 seconds

Logging into Jahia

You are now ready to connect to Jahia. 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: