How to Install Zammad Ticketing System on Ubuntu Linux

This brief tutorial shows students and new users how to install the Zammad help desk and ticketing system on the Ubuntu 18.04 | 16.04 server.

Installing the Zammad help desk and ticketing system on Ubuntu Linux can help organizations manage customer support and ticketing tasks more efficiently.

Zammad is a free, open-source web-based support and ticketing solution that provides popular features in other ticketing platforms, including escalation management, customer communication over multiple channels, issues resolution, ticket routing, and more.

Ubuntu Linux is a popular and reliable operating system that is easily configured to run Zammad.

By installing Zammad on Ubuntu Linux, organizations can access a powerful ticketing system to streamline their customer support tasks and improve their overall customer experience.

For more about Zammad, please browse its homepage.

When you’re ready to install Zammad, follow the steps below:

Install | Setup Elasticsearch

Elasticsearch is a dependency of Zammad and needs to be provided before installing Zammad.

To install Elasticsearch on Ubuntu, run the commands below:

sudo apt-get install apt-transport-https sudo wget
sudo echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-7.x.list
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

sudo apt-get update
sudo apt-get install openjdk-8-jre elasticsearch
sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

After installing, run the commands below to restart and enable Elasticsearch.

sudo systemctl restart elasticsearch
sudo systemctl enable elasticsearch

Add Zammad DEB Repository to Ubuntu

Installing Zammad on Ubuntu is easy. Simply add its repository to Ubuntu and install it from it.

You don’t need special hardware requirements to install and run Zammad. Its installer will automatically download and install all the dependencies for you.

On Ubuntu 18.04, run the below commands to add its repository:

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/18.04.repo

On Ubuntu 16.04, run the command instead:

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/16.04.repo

Install Zammad

Run the commands below to update the systems’ repository files and install Zammad.

sudo apt-get update
sudo apt-get install zammad

After installing Zammad, simply go to the server’s local hostname, and the Zammad portal should be accessible.

Example:

http://localhost

You must create a new admin user when connecting to the server.

Complete the setup and start using the system.

If you want to access the platform over your domain name, then simply make the changes below by running the commands below:

Run the command to open the Zammad vhost config file.

sudo nano /etc/nginx/sites-enabled/zammad.conf

Then replace the hostname with your domain name as highlighted below:

#
# this is the nginx config for zammad
#
upstream zammad-railsserver {
    server 127.0.0.1:3000;
}

upstream zammad-websocket {
    server 127.0.0.1:6042;
}

server {
    listen 80;

    # replace 'localhost' with your fqdn if you want to use zammad from remote
    server_name example.com;

    root /opt/zammad/public;

    access_log /var/log/nginx/zammad.access.log;
    error_log  /var/log/nginx/zammad.error.log;

    client_max_body_size 50M;

Save the file and exit

Restart Nginx

sudo systemctl reload nginx

Now you should be able to access Zammad over your domain

After all the steps above, run these last commands to complete the setup and configure Zammad to work with Elasticsearch.

sudo zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"
sudo zammad run rake searchindex:rebuild

Conclusion:

This post showed you how to install Zammad’s free support and ticketing platform on Ubuntu. If you find any errors above, please comment below.

You may also like the post below: