Zammad is an open-source helpdesk and customer support system that allows you to manage customer tickets, chats, and emails. In this tutorial, we will guide you through the steps of installing Zammad on Ubuntu Server.
Before starting the installation, make sure that you have:
It's always a good idea to update your system before installing any new software. You can update your system by running the following commands:
sudo apt update
sudo apt upgrade
Zammad requires some dependencies to be installed before the installation. Use the following command to install the required dependencies:
sudo apt install build-essential curl git-core gnupg2 libssl-dev postgresql-client nginx redis-server elasticsearch nodejs -y
You can install Zammad by following these steps:
First, import the Zammad GPG key:
wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
Add the Zammad repository to your system with the following command:
sudo curl -sS https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/$(lsb_release -r -s)/repo.list | sudo tee /etc/apt/sources.list.d/zammad.list
Update your system repository and install the Zammad package:
sudo apt update
sudo apt install zammad
After the installation, you need to configure Zammad by setting the database, Elasticsearch, and Nginx.
Zammad supports PostgreSQL as a database. In this tutorial, we will use PostgreSQL as a database.
Install PostgreSQL by running the following command:
sudo apt install postgresql-12 postgresql-client-12
Create a PostgreSQL user and database for Zammad by running the following commands:
sudo -u postgres createuser --pwprompt zammad
sudo -u postgres createdb -O zammad zammad_production
Zammad requires Elasticsearch to function correctly. In this tutorial, we will install Elasticsearch version 7.
Install Elasticsearch by running the following command:
sudo apt install openjdk-8-jre-headless -y
wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.10.2-amd64.deb
sudo dpkg -i elasticsearch-7.10.2-amd64.deb
Update the Elasticsearch configuration file /etc/elasticsearch/elasticsearch.yml by adding the following line:
network.host: localhost
Then, start and enable the Elasticsearch service with the following commands:
sudo systemctl start elasticsearch
sudo systemctl enable elasticsearch
Zammad requires Nginx to act as a reverse proxy. In this tutorial, we will install Nginx version 1.18.0.
Install Nginx by running the following command:
sudo apt install nginx -y
Create an Nginx configuration file for Zammad /etc/nginx/sites-available/zammad.conf by adding the following code:
upstream zammad {
server 127.0.0.1:3000;
keepalive 64;
}
server {
listen 80;
listen [::]:80;
server_name yourdomain.com;
location / {
proxy_pass http://zammad;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Then enable the configuration file by creating a symbolic link:
sudo ln -s /etc/nginx/sites-available/zammad.conf /etc/nginx/sites-enabled/
Finally, test and reload the Nginx configuration:
sudo nginx -t
sudo systemctl reload nginx
After completing the configuration, you can access Zammad by opening your web browser and typing the domain name or IP address of your server. The default login credentials are:
adminadminIn this tutorial, we have successfully installed and configured Zammad on Ubuntu Server latest version. By following the steps mentioned above, you can set up a helpdesk system to manage customer support tickets, chats, and emails.
If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!
