How to Install openCRX CRM on Ubuntu 18.04 | 16.04

This brief tutorial shows students and new users how to install Apache openCRX CRM platform on Ubuntu 18.04 | 16.04.

Apache openCRX is a Java based web framework that provides enterprise-wide CRM platform for businesses that want to manage their customers relationships.

openCRX is very flexible and comes with a wide range of modules, including sales generation, sales fulfillment, marketing and service activities to customers, partners, suppliers and many more right out of the box.

When looking for an open source enterprise CRM platform for your business, openCRX is a good place to start. This open source is built on Java framework and offers features that help you run your business and collaborate with your customers.

For more about openCRX, please check its homepage.

To get started with installing Apache openCRX on Ubuntu, please follow the steps below:

Step 1: Install OpenJDK 8

Apache openCRX is a Java based app so you’ll need Java installed. First, download the Java 8 Development Kit: either the official Oracle JDK or Open JDK

For this tutorial, we’re going to be install OpenJDK.

To do that, run the commands below:

sudo apt update
sudo apt-get install openjdk-8-jdk openjdk-8-doc openjdk-8-jre-lib

After installing Java, you can verify it by running the commands below:

java -version

It should output something similar as shown below:

openjdk version "1.8.0_242"
OpenJDK Runtime Environment (build 1.8.0_242-8u242-b08-0ubuntu3~18.04-b08)
OpenJDK 64-Bit Server VM (build 25.242-b08, mixed mode)

After, continue below to install Apache Ant.

Step 2: Download and Install Ant

Apache Ant is also required to run openCRX.

If you want to manually download and install Apache Ant yourself, simply follow the steps below:

You can download Ant distribution from the Apache Ant website. Currently, the latest release of Ant is version 1.10.7.

To download, run the commands below, then extract it.

cd /tmp
sudo tar -xf apache-ant-1.10.7-bin.tar.gz -C /usr/local

The above command will unpack the Ant distribution to /usr/local/apache-ant-1.10.7

Next, create a symbolic link to the Ant distribution by running the commands below.

sudo ln -s /usr/local/apache-ant-1.10.7/ /usr/local/ant

After that, create a file at /etc/profile.d folder.

sudo nano /etc/profile.d/

Copy and paste these lines into the file and save it.

export ANT_HOME=/usr/local/ant
export PATH=${ANT_HOME}/bin:${PATH}

Save the file and exit.

After that, run the command below to activate the above environment variables.

source /etc/profile

You can verify Ant version by running the commands below:

ant -version

Notice a latest version is now used?

Apache Ant(TM) version 1.10.7 compiled on September 1 2019

This is how to install Apache Ant on Ubuntu.

Step 3: Download and Install openCRX

Now that Java and Ant are installed, run the commands below to download and install openCRX package. At the time of this writing, the latest version of openCRX is 4.2.0.

You can download the latest from the link below:

Or use the commands below:

cd /tmp

After downloading the file, run the commands below to run the installer.

java -jar opencrxServer-4.2.0-installer.jre-1.8.jar

That should begin the installer wizard. Follow the screenshots below to setup your environment.

openCRX Ubuntu Install

Select the home directory of your JDK 1.8 installation (automatically selected if the environment
variable JAVA_HOME is set) – for example /usr/lib/jvm/java-8-openjdk-amd64 – and then click
Next to continue:

openCRX Ubuntu setup

Select the home directory of your Ant installation (automatically selected if the environment
variable ANT_HOME is set correctly) – for example /usr/local/ant – and then click Next
to continue:

openCRX setup ubuntu

Select the installation directory – for example /home/crx/opencrxServer-4.2.0 – and then click
Next to continue. Note that if you choose to create a new directory you will have to confirm
your choice by clicking OK in the respective pop-up.

openCRX Ubuntu install

Verify the configuration and click Next to continue.

openCRX Ubuntu Setup

Next, create a shortcut for the current user and continue

openCRX Ubuntu setup

After that the setup should be complete.

Launch the shortcut Start openCRX Server 4.2.0 (8080).

If you did not create the shortcuts (or if the installer could not create them) you can start
openCRX Server with the command:

cd ~/opencrxServer-4.2.0/apache-tomee-plus-7.0.5/bin
./ run

That should startup the server.

Next, open your browser and browse to the server’s IP address or hostname and port #8080 followed by: opencrx-core-CRX


Login with the username and password below:

Username: admin-Root
Password: admin-Root

openCRX Ubuntu install

To change the admin username and password, open the configuration file below:

nano ~/opencrxServer-4.2.0/apache-tomee-plus-7.0.5/conf/tomcat-users.xml

Then edit the highlighted line show below:

<?xml version='1.0' encoding='utf-8'?>
<role rolename="OpenCrxAdministrator"/>
<role rolename="OpenCrxUser"/>
<role rolename="Guest"/>
<role rolename="OpenCrxRoot"/>
<role rolename="tomcat"/>
<role rolename="manager"/>
<user username="admin-Root" password="admin-Root" roles="OpenCrxRoot,manager"/>
<user username="tomcat" password="tomcat" roles="tomcat"/>
<user username="admin-Standard" password="admin-Standard" roles="OpenCrxAdministrator"/>
<user username="both" password="tomcat" roles="tomcat"/>
<user username="guest" password="guest" roles="OpenCrxUser,Guest"/>

Save the file and exit

openCRX setup Ubuntu

That’s it!


You have learned how to install Apache openCRX on Ubuntu 18.04 | 16.04. If you find any error above, please use the form below to report it.


You may also like the post below:

Leave a Comment

Your email address will not be published.