How To Install OTRS on Ubuntu 16.04 LTS

Install OTRS on Ubuntu 16.04 LTS

In this tutorial, we will show you how to install and configure OTRS on Ubuntu 16.04 LTS server. For those of you who didn’t know, OTRS (Open-Source Ticket Request System) is a web-based ticketing system, widely used by businesses for services like customer support, help desks, and call centers. The software is separated into several parts, the main section being the OTRS framework, which contains all central functions for the application and the ticket system

This article assumes you have at least basic knowledge of Linux, know how to use the shell, and most importantly, you host your site on your own VPS. The installation is quite simple and assumes you are running in the root account, if not you may need to add ‘sudo‘ to the commands to get root privileges. I will show you the step-by-step installation of OTRS on a Ubuntu 16.04 (Xenial Xerus) server.

Install OTRS on Ubuntu 16.04 LTS

Step 1. First, make sure that all your system packages are up-to-date by running the following apt-get commands in the terminal.

sudo apt-get update
sudo apt-get upgrade

Step 2. Installing MariaDB.

Install MariaDB on the server using apt-get the command:

sudo apt-get install mariadb-server

By default, MariaDB is not hardened. You can secure MariaDB using the mysql_secure_installation script. you should read and below each step carefully which will set a root password, remove anonymous users, disallow remote root login, and remove the test database and access to secure MariaDB:


Configure it like this:

- Set root password? [Y/n] y
- Remove anonymous users? [Y/n] y
- Disallow root login remotely? [Y/n] y
- Remove test database and access to it? [Y/n] y
- Reload privilege tables now? [Y/n] y

Once installed, OTRS requires that you change the following settings:

nano /etc/mysql/my.cnf

Under the [mysqld] section, paste:

max_allowed_packet   = 20M
query_cache_size     = 32M
innodb_log_file_size = 256M

Start MariaDB with the system:

systemctl start mysql
systemctl enable mysql

Step 3. Installing OTRS (OpenSource Trouble Ticket System).

The first thing to do is to go to OTRS’s download page and download the latest stable version of OTRS:


Unpack the OTRS archive to the document root directory on your server:

tar xpf otrs-5.0.16.tar.bz2
mv otrs-5.0.16 /opt/otrs

Check if the system contains all required PERL modules and install required modules with apt (as suggested by the script), executing the command:

perl /opt/otrs/bin/

Create an OTRS user:

useradd -d /opt/otrs -c 'OTRS user' otrs
usermod -G www-data otrs

Default config files In /opt/otrs, execute the following command:

cp Kernel/ Kernel/

Step 4. Configure Apache webserver.

Check installed modules and configure Apache:

perl -cw /opt/otrs/bin/cgi-bin/
perl -cw /opt/otrs/bin/cgi-bin/
perl -cw /opt/otrs/bin/

If the response is “syntax OK” for all, it means that the Perl modules have been installed successfully.

Next, install the Apache web server and mod_perl, using apt-get the command:

apt-get install apache2 libapache2-mod-perl2

In /opt/otrs there is a configuration file for Apache. Link it to the webserver configuration directory:

ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/conf-enabled/zzz_otrs.conf

OTRS requires a few Apache modules to be active for optimal operation:

a2enmod perl
a2enmod headers
a2enmod version
a2enmod deflate
a2enmod filter

Finally, Restart the webserver so it will load new configurations:

systemctl restart apache2

We will need to change some folders permissions:

bin/ --web-group=www-data

Step 5. Accessing OTRS.

OTRS will be available on HTTP port 80 by default. Open your favorite browser and navigate to or http://your-server-ip/otrs/ and complete the required steps to finish the installation. If you are using a firewall, please open port 80 to enable access to the control panel.

Install OTRS on Ubuntu 16.04 LTS

Congratulations! You have successfully installed OTRS. Thanks for using this tutorial for installing OTRS (OpenSource Trouble Ticket System) on Ubuntu 16.04 Xenial Xerus server. For additional help or useful information, we recommend you check the official OTRS website.

VPS Manage Service Offer
If you don’t have time to do all of this stuff, or if this is not your area of expertise, we offer a service to do “VPS Manage Service Offer”, starting from $10 (Paypal payment). Please contact us to get the best deal!



r00t is a seasoned Linux system administrator with a wealth of experience in the field. Known for his contributions to, r00t has authored numerous tutorials and guides, helping users navigate the complexities of Linux systems. His expertise spans across various Linux distributions, including Ubuntu, CentOS, and Debian. r00t's work is characterized by his ability to simplify complex concepts, making Linux more accessible to users of all skill levels. His dedication to the Linux community and his commitment to sharing knowledge makes him a respected figure in the field.
Back to top button