How to Install Zammad on Debian Latest
Zammad is a free, open-source helpdesk and support ticket system that can handle customer inquiries across various channels like email, phone, chat, and social media. In this tutorial, we will guide you through the process of installing Zammad on Debian Latest.
Prerequisites
- A Debian Latest instance.
- SSH access to your Debian Latest instance.
- A non-root user with sudo privileges.
Step 1: Update the System
Before installing Zammad on Debian Latest, it is recommended to update the system to the latest version.
sudo apt update
sudo apt upgrade
Step 2: Install Dependencies
Zammad requires some dependencies to be installed on your Debian instance. Run the following command to install required packages:
sudo apt-get install curl git gnupg2 liblzma-dev libmariadbclient-dev libpq5 libqt5webkit5-dev libreadline-dev libssl-dev libxml2-dev libxslt1-dev logrotate postgresql postgresql-contrib python3 python3-dev python3-pip python3-venv yarn zlib1g-dev
Step 3: Install Ruby
Zammad is written in Ruby. So, you need to install Ruby on your Debian Latest instance to run Zammad. You can install it with the following command:
sudo apt install ruby-full
Step 4: Install ElasticSearch
Zammad requires a search engine to index and search data. Although Zammad comes with its own search engine, it is recommended to use ElasticSearch.
Install ElasticSearch using the following commands:
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -
echo "deb https://artifacts.elastic.co/packages/7.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elastic-7.x.list
sudo apt update
sudo apt install elasticsearch
After installation, start and enable the ElasticSearch service:
sudo systemctl start elasticsearch
sudo systemctl enable elasticsearch
To ensure that the ElasticSearch service is running, run the following command:
curl http://localhost:9200
Step 5: Install Zammad
Now that you have installed all the prerequisites, you can proceed with the Zammad installation. Perform the following steps one by one to install Zammad:
Step 5.1: Add Zammad Repository
Zammad offers its own repository. Add the Zammad repository to your system:
wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/debian/$(lsb_release -cs)/repository.deb
Now, import the GPG key:
sudo curl https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
Step 5.2: Install Zammad
Update your system once again and install Zammad:
sudo apt update
sudo apt install zammad
Step 5.3: Start Zammad
Start the Zammad service with the following command:
sudo systemctl start zammad
Verify that the service is running:
sudo systemctl status zammad
Step 6: Accessing Zammad
You can now access Zammad by opening your browser and navigating to:
http://yourdomain.com/
Zammad will prompt you to set up the admin user and configure your email settings to start using its features.
Conclusion
You have successfully installed Zammad on your Debian Latest instance. You can now manage your customer inquiries and support tickets using this feature-rich helpdesk system.