Install OTRS (OTOBO) ticketing system on CentOS 8

You can download this article in PDF format via the link below to support us.
Download the guide in PDF formatshut down

OTOBO is an intelligent, agile, and flexible communication platform and service management suite based on ((OTRS)) Community Edition. This version was announced at the end of December 2020 (EOL). Boyfriend Contains management dashboards, agent portals and customer portals for customer service, help desk and IT service management. The software was created to be extensible and integrate well with other systems. In this guide, we will guide you through the installation steps of OTOBO OTRS ticketing system on CentOS 8 Linux system.

OTOBO can be used to process a few tickets per month or hundreds of tickets per day. The hardware requirements depend to a large extent on the required use case. Storage requirements also depend on the number of tickets and the size of attachments. The software requirements for running (OTOBO) OTRS are:


  • Perl 5.16.0 or higher
  • Perl package list /opt/otrs/bin/ Console command

Network Server

  • Apache 2
  • Nginx
  • Any other web server that can be used as a reverse proxy


  • MySQL 5.7 or higher
  • MariaDB 10.2 or higher
  • PostgreSQL 9.2 or higher
  • Oracle 10g or higher

Step 1: Update the system

Start the installation by updating the CentOS 8 system to the latest version:

sudo yum -y update

Wait for the system software package to be upgraded, and if there are kernel-related updates, reboot the system.

Step 2: Install Docker on CentOS 8

We will use Docker method to run OTOBO (OTRS) on CentOS 8 system. Since Docker is not part of the CentOS server installation, we need to install it manually.

Before installing Docker Engine on the new host for the first time, you need to set up the Docker repository:

sudo yum install -y yum-utils
sudo yum-config-manager --add-repo

After that, install the latest version of Docker Engine and use the container:

sudo yum -y install iptables docker-ce docker-ce-cli

Start the Docker service after installation:

sudo systemctl start docker
sudo systemctl enable docker

The Docker service should return to a green status-running:

$ sudo systemctl status docker
● docker.service - Docker Application Container Engine
   Loaded: loaded (/usr/lib/systemd/system/docker.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2021-04-06 10:47:25 UTC; 5s ago
 Main PID: 35953 (dockerd)
    Tasks: 10
   Memory: 44.1M
   CGroup: /system.slice/docker.service
           └─35953 /usr/bin/dockerd -H fd:// --containerd=/run/containerd/containerd.sock

Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.415220323Z" level=info msg="[graphdriver] using prior storage driver: over>
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.416922290Z" level=warning msg="Your kernel does not support cgroup blkio w>
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.416948751Z" level=warning msg="Your kernel does not support cgroup blkio w>
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.417204840Z" level=info msg="Loading containers: start."
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.570487095Z" level=info msg="Default bridge (docker0) is assigned with an I>
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.635698877Z" level=info msg="Loading containers: done."
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.661056788Z" level=info msg="Docker daemon" commit=363e9a8 graphdriver(s)=o>
Apr 06 10:47:25 dockerd[35953]: time="2021-04-06T10:47:25.661222532Z" level=info msg="Daemon has completed initialization"
Apr 06 10:47:25 systemd[1]: Started Docker Application Container Engine.

Step 3: Install Docker Compose on CentOS 8

Follow the guide in the link to install Docker Compose on CentOS 8:

Install Docker Compose on Linux

Confirm the installation by checking the software version:

$ docker-compose version
docker-compose version 1.28.6, build 5db8d86f
docker-py version: 4.4.4
CPython version: 3.7.10
OpenSSL version: OpenSSL 1.1.0l  10 Sep 2019

Step 4: Use Docker to deploy OTRS (OTOBO) on CentOS 8

After installing Docker and Docker compose, we can install OTOBO on the CentOS 8 server.

Install git:

sudo yum -y install git

Pull the latest Otobo code:

$ git clone

Cloning into 'otobo-docker'...
remote: Enumerating objects: 244, done.
remote: Counting objects: 100% (244/244), done.
remote: Compressing objects: 100% (131/131), done.
remote: Total 473 (delta 126), reused 189 (delta 83), pack-reused 229
Receiving objects: 100% (473/473), 91.76 KiB | 15.29 MiB/s, done.
Resolving deltas: 100% (269/269), done.

Confirm whether the folder contains the files we need:

$ ls otobo-docker
docker-compose  etc  LICENSE  scripts

Docker Compose configuration file .env Allows you to manage the installation of OTOBO

$ ls otobo-docker/.docker_compose_env_http*
otobo-docker/.docker_compose_env_http   otobo-docker/.docker_compose_env_https_custom_nginx
otobo-docker/.docker_compose_env_https  otobo-docker/.docker_compose_env_https_selenium

If you plan to access the OTOBO web application via HTTPS, please use .docker_compose_env_https. It is recommended to access the operation via HTTPS. If HTTPS is not needed, use .docker_compose_env_http as a starting point.

cd otobo-docker
cp -p .docker_compose_env_http .env # or .docker_compose_env_https for HTTP

Configure the password of the database administrator user

Change the following settings in your .env file:

$ vim .env

A database administrator user is required to create a database user Sound room And database architecture Sound room. OTOBO will actually use a dedicated database user Sound room.

Use Docker Compose to start a Docker container

After completing the configuration, use the following command to start the Docker container:

$ docker-compose up --detach
Digest: sha256:b0135c94e866953af1db5be72759c5f68f25f756d2673cbe21cbca5ae54adddf
Status: Downloaded newer image for rotheross/otobo:latest
Creating otobo_redis_1   ... done
Creating otobo_elastic_1 ... done
Creating otobo_db_1      ... done
Creating otobo_web_1     ... done
Creating otobo_daemon_1  ... done

Check if the container started successfully:

$ docker-compose ps
     Name                    Command               State          Ports
otobo_daemon_1    /opt/otobo_install/entrypo ...   Up
otobo_db_1 --max ...   Up      3306/tcp
otobo_elastic_1   /tini -- /usr/local/bin/do ...   Up      9200/tcp, 9300/tcp
otobo_redis_1 redis ...   Up      6379/tcp
otobo_web_1       /opt/otobo_install/entrypo ...   Up>5000/tcp

List used volumes:

$ docker volume ls
local     otobo_elasticsearch_data
local     otobo_mariadb_data
local     otobo_opt_otobo
local     otobo_redis_data

Install and start OTOBO

Run the OTOBO installer in https://yourIPorFQDN/otobo/

Click”Next“start installation.

Agree to the license agreement.Install OTOBO OTRS CentOS 08 02

Select the database you want to use.Install OTOBO OTRS CentOS 08 03

Enter the password of the root database user set in .envInstall OTOBO OTRS CentOS 08 04

select”Check database settings“. This will verify that the credit is valid.Install OTOBO OTRS CentOS 08 05

Use “Next” to proceed to the next step.Install OTOBO OTRS CentOS 08 06

Edit the system settings as needed.Install OTOBO OTRS CentOS 08 07

After completing the configuration, the page URL, user and password details will be displayed on the screen. Keep the details in a safe place.Install OTOBO OTRS CentOS 08 08

Log in by clicking on the URL and entering the username and passwordInstall OTOBO OTRS CentOS 08 09

So far, the successful installation of OTRS (OTOBO) on CentOS 8 is cheered.


Read more articles:

  • Must-read books for learning Java programming
  • The best books to help you start an online business
  • Best Certified Scrum Master Preparation

You can download this article in PDF format via the link below to support us.
Download the guide in PDF formatshut down

Related Posts