Written by The Jahia Team
 
Sysadmins
   Estimated reading time:

The following table shows details on the installation of the jahia/jahia-dev image and its packaged dependencies.

Pull command docker pull jahia/jahia-dev:8.0.0.0
Exposed port 8080 (HTTP)
Min/Max memory 2GB/4GB (allocated to the JVM)
vCPU requirements 2 vCPUs
JVM Version OpenJDK 11.0.3+7
Directory to mount as volumes /opt/jahia/dx/digital-factory-data. See Volume management for more details.

Quick start

The basic Jahia start command is:

docker run -it -p 8080:8080 jahia/jahia-dev:8.0.0.0

where -p 8080:8080 binds the 8080 port of your host machine to the 8080 port of the container and 8.0.0.0 is your Jahia version number.

When you execute this command, Jahia starts and is available through your host machine’s browser on the 8080 port. The initial startup of Jahia takes a few minutes. When finished, a log similar to the following will appear:

Jahia 8.0.0.0 - Enterprise Distribution is now ready. Initialization completed in 45 seconds

To test the container, use the following URL in your favorite web browser to access the Jahia login page:

http://localhost:8080/

The default credentials are:

  • Jahia Administration
    root/root
  • Jahia Tools
    jahia/password

Additional configuration

Jahia can be configured by passing environment variables to the container at startup (see the Custom configuration deployment section to learn more).

Environment variable Default Description
TZ N/A Passes a timezone to the container, for example “America/Toronto”
JAHIA_JAVA_OPTS N/A Used to pass JVM options to Jahia
JAHIA_JAVA_XMS N/A  
JAHIA_JAVA_XMX 2G  

Upgrading the jahia/jahia-dev image

The jahia/jahia-dev Docker image doesn't support upgrades. Developers often delete their dev environment and recreate a new one based on a new Docker tag.

Remote debugging

The Tomcat remote debug feature can be enabled so that you can use an IDE. This allows you to place a breakpoint and inspect the application's behavior at runtime. To do so, use the following parameters at runtime:

JAHIA_JAVA_OPTS=-agentlib:jdwp=transport=dt_socket,address=*:8000,server=y,suspend=n -p  8080:8080 -p  8101:8101 -p 8000:8000

Your IDE can now connect to the remote debug port 8000 of Tomcat.