Installing Jahia Community and Enterprise distributions

November 14, 2023

Introduction

This document intends to help users and developers to do a first and fast install of Jahia, mainly for a first discovery.

What’s in this documentation?

This document presents the simplest installation process for

  • Jahia Community Distribution
  • Jahia Enterprise Distribution

Subscription customers using the Enterprise Distribution should also refer to the installation chapter of the Installing, configuring and monitoring Jahia, to have a complete understanding of all installation options.

What this guide is not

This guide is not a complete installation guide, it does not explain all available options (DB, OS, Application Servers, external libs, production environments, etc.) nor advanced configurations some of which are only available to our subscription customers.

Jahia Community and Enterprise Distributions

Content and Main differences

The Community Distribution is the 100% free and open source distribution of Jahia, under GPLv3 license. The Enterprise Distribution is available through a business-friendly license (JSEL) and is designed to meet the needs of the most demanding mission-critical projects.

The Enterprise Distribution differentiates from the Community Distribution by the Digital Industrialization tools it embarks:

  • The Private AppStore software
  • Roles and advanced workflows
  • User directories and SSO (such as LDAP or AD)
  • Distant publishing
  • Clustering
  • Complex environments support (such as WebSphere or Oracle)
  • The possibility to install specific packages like Portal Factory providing features like the Esigate or CMIS integration.

The Community Distribution share the exact same code base as the Enterprise Distribution (we don’t want to provide crapware, early stage or unstable version to our community) but people based and the Community Distribution cannot access to the monthly hotfixes and are not supported by the Jahia teams.

The Enterprise Distribution is available through annual subscriptions that encompass the additional Digital Industrialization tools, unlimited bug fixes, Online Technical Assistance and specific SLAs for both development and production environments.

Prices for the subscriptions can be found on the Pricing page from the website.

Installing Jahia Community Distribution

The following procedure is presented with the Mac version, but there are both Windows and Linux versions also available.

Procedure

First, download the latest Jahia Community Distribution for Mac. Note that you can find the Windows distribution here.

Once the download is finished, launch the jar package from the repository where you have download the package and type the following command in a terminal window (use the downloaded file):

java -jar Jahia-CommunityDistribution-7.x.x.x-rXXXX.jar

and then follow the process through the different steps of the installation tool.

First, select your language:

You must click on Next for each page, agree to the License Agreement and define a root password when asked.

Accept the license agreement

Choose a path or accept the proposed one.

Jahia will ask for the authorization to create the destination folder, please accept.

For a quick start, we will use the “Discovery” installation that comes with an embedded application server, an embedded DB and all optional modules. For elaborated developments or production servers, please choose a custom installation on an external DB server.


Set a password for the “root” account.


If some optional tools are available on the computer on which you’re installing Jahia, the paths should be detected automatically. Those tools are used by Jahia to perform some operations or improve some operations compared to embedded java classes. If they are not installed on your computer, that will not impeach Jahia to run properly.


Jahia summarizes the chosen settings before proceeding to the installation.


Jahia installation process is actually running


Jahia installation process is finished

For the first startup and auto-configuration, type the following command in a Terminal window:

./start.sh

 

When Jahia is ready, you are able to access it through a web browser by typing the following address:

http://localhost:8080/start

Jahia will ask you to login with your username and password.

15-slide-4.png

Installing Jahia Enterprise Distribution

The following procedure is presented with the Windows version, but there are both Mac and Linux versions also available.

Procedure

First, download the latest Jahia Enterprise Package.

Please note the Enterprise Distribution packages are 30-day trial version.

Once the download is finished, double click on installer.exe then follow the steps of the installation tool. You must click on Next for each page, agree to the License Agreement and define a root password when asked.

Accept the license agreement

Choose a path or accept the proposed one.


Jahia will ask for the authorization to create the destination folder, please accept.

To discover some of the Enterprise Distribution capabilities, select the “Custom Install”

If needed, choose to install Apache Tomcat.

Select the database system you want to use. For testing or development purposes, you can select the Embedded Apcahe Derby DB. Otherwise, you can choose to connect to standalone DBMS: MariaDB, MySQL, SQL Server, Oracle or PostgreSQL:

installer-step-07-dbms-type.png

In such case you will need to provide the DB connection settings:

installer-step-10-db-connection-config.png

For the advanced installation with manually creating database structure (tables, indexes, sequences), please, refer to the chapter Database of the configuration and fine tuning guide.

Choose a password for the Jahia Tools

Configure your Web application.

Configure the Apache Tomcat that is about to be installed.

Select the operating mode you want to work into and check the LDAP and Cluster configuration check boxes.

You can then configure your LDAP provider.

and your Cluster configuration as well as.


Now configure the system administrator account. Only password information for the root account are mandatory.

Though optional, the mail system used on the web server can be set here.

Though also optional, Jahia studio tools can be set here if some or all are not already targeted.


If some optional tools are available on the computer on which you’re installing Jahia, the paths should be detected automatically. Those tools are used by Jahia to perform some operations or improve some operations compared to embedded java classes

Additional setting such as default language, license file or additional modules will be done here.

Runtime data and configuration path are set here.

 


Jahia summarizes the chosen settings before proceeding to the installation


Jahia installation process is actually running


Jahia installation process is finished

The first startup and auto-configuration can be followed in the Tomcat console

When Jahia is ready, you are able to access it through a web browser by typing the following address:

http://localhost:8080/start

Jahia will ask you to login with your username and password.

Going further

If this is your first time using Jahia, see the following topics for more information about Jahia

  • Discovering Jahia
    Provides an overview of creating and managing content in Jahia.
  • Introducing Jahia technical concepts
    Provides a technical introduction to Jahia. It is intended as a starting point into the platform for users with technical skills such as integrators, developers, and testers.