- \n
- Install Zammad Ticketing System<\/li>\n
- Install and Configure Letsencrypt<\/li>\n
- Configure Nginx Web server<\/li>\n
- Zammad Configuration<\/li>\n
- Zammad Additional Tips<\/li>\n<\/ol>\n
Prerequisites<\/h2>\n
- \n
- CentOS 7 System<\/li>\n
- At least 2GB RAM<\/li>\n
- Root Privileges<\/li>\n<\/ul>\n
Step 1 – Install Zammad Ticketing System<\/h2>\n
Before installing Zammad ticketing system on CentOS 7, we need to install EPEL (Extra Packages for Enterprise Linux) repository for our Nginx web server installation.<\/p>\n
Add EPEL repository by installing the epel package using the following yum command.<\/p>\n
sudo yum -y install epel-release<\/p>\n
EPEL repository has been added to the system.<\/p>\n
Next, import the Zammad key with the rpm import command.<\/p>\n
sudo rpm –import https:\/\/rpm.packager.io\/key<\/p>\n
Add the Zammad repository by creating a new .repo file in the ‘yum.repos.d’ directory using the vim editor<\/a>.<\/p>\n
vim \/etc\/yum.repos.d\/zammad.repo<\/p>\n
Paste the following info there.<\/p>\n
[zammad]
That’s it. Save and exit.<\/p>\n
Now install Zammad using the following yum command.<\/p>\n
sudo yum -y install zammad<\/p>\n
Note: <\/strong>When we are installing Zammad, it will automatically install other required packages, including Nginx web server and PostgreSQL database.<\/p>\n
And after the installation is complete, you will see the result similar to the one shown below.<\/p>\n
![\"Install](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7.png\" "\\"\\"")
<\/a><\/p>\nZammad and other packages – Nginx web server and PostgreSQL database – have been installed.<\/p>\n
Step 2 – Install and Configure Letsencrypt SSL<\/h2>\n
In this tutorial, we want to set up Zammad under Nginx HTTPS and using free SSL from the Letsencrypt. And we will do that in this step and use the certbot tool (Letsencrypt Agent) that can be installed from the repository.<\/p>\n
Install certbot package tool from the repository using yum.<\/p>\n
yum -y install certbot<\/p>\n
Next, we need to generate new SSL certificates with the certbot tool. Make sure you have your own domain to generate the certificate files. We will use a domain name ‘zammad.hakase-labs.com’.<\/p>\n
Go to the Nginx configuration directory and open the nginx.conf file in the vim editor.<\/p>\n
cd \/etc\/nginx\/
vim nginx.conf<\/p>\nPaste the following configuration under the ‘server {}<\/strong>‘ block.<\/p>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 location ~ \/.well-known {Save and exit. Then test the configuration and restart the web server.<\/p>\n
nginx -t
systemctl restart nginx<\/p>\n![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-1.png\" "\\"\\"")
<\/a><\/p>\nBefore generating SSL certificate files, make sure your system port for HTTP and HTTPS is not blocked by the firewall. You can open the HTTP and HTTPS ports on CentOS using the firewall-cmd command as shown below.<\/p>\n
firewall-cmd –permanent –add-service=https
firewall-cmd –reload<\/p>\nNow generate SSL certificate files using the following certbot command.<\/p>\n
certbot certonly –standalone -d zammad.hakase-labs.co<\/p>\n
You will be asked about your email address for renewing notification – type your email address and press ‘Enter<\/strong>‘ to continue. For Letsencrypt Term Of Services (TOS), type ‘A<\/strong>‘ to agree. Similarly, when asked to share email with EFF Foundation, just type ‘N<\/strong>‘ for no.<\/p>\n
![\"Create](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-2.png\" "\\"\\"")
<\/a><\/p>\nWhen the certbot command is complete, you will see the result as shown below.<\/p>\n
![\"Certbot](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-3.png\" "\\"\\"")
<\/a><\/p>\nNew SSL certificate files for our Zammad installation has been generated. All certificates are in the ‘\/etc\/letsencryp\/live\/<\/strong>‘ directory.<\/p>\n
Step 3 – Configure Nginx Web server<\/h2>\n
In this step, we will configure a virtual host file for Zammad. It’s automatically created in the ‘\/etc\/nginx\/conf.d\/’ directory during zammad installation.<\/p>\n
Go to the ‘\/etc\/nginx\/conf.d<\/strong>\/’ and edit the zammad.conf<\/strong> file.<\/p>\n
cd \/etc\/nginx\/conf.d\/
vim zammad.conf<\/p>\nChange all configuration as shown below.<\/p>\n
#
upstream zammad {
upstream zammad-websocket {
server {
server {
\u00a0\u00a0\u00a0 ssl_certificate \/etc\/letsencrypt\/live\/zammad.hakase-labs.co\/fullchain.pem;
\u00a0\u00a0\u00a0 # replace 'localhost' with your fqdn if you want to use zammad from remote
\u00a0\u00a0\u00a0 root \/opt\/zammad\/public;<\/p>
\u00a0\u00a0\u00a0 access_log \/var\/log\/nginx\/zammad.access.log;
\u00a0\u00a0\u00a0 client_max_body_size 50M;<\/p>
\u00a0\u00a0\u00a0 location ~ ^\/(assets\/|robots.txt|humans.txt|favicon.ico) {
\u00a0\u00a0\u00a0 location \/ws {
\u00a0\u00a0\u00a0 location \/ {
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 gzip on;
Save and exit.<\/p>\n
Next, test Nginx configuration and make sure there is no error. Then restart the web server.<\/p>\n
nginx -t
systemctl restart nginx<\/p>\nThe zammad virtual host file is now using SSL. Check with the netstat command and make sure you have port 443<\/strong> for HTTPS with the state ‘LISTEN<\/strong>‘.<\/p>\n
netstat -plntu<\/p>\n
![\"Configure](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-4.png\" "\\"\\"")
<\/a><\/p>\nStep 4 – Zammad Configuration<\/h2>\n
Zammad has been installed on CentOS 7 with Nginx as a web server and PostgreSQL as a database server, and it’s running under HTTPS connection. In this step, we will do basic configuration of Zammad Ticketing System.<\/p>\n
Open your web browser and type zammad address ‘zammad.hakase-labs.co’. You will be redirected to the HTTPS connection. Click the ‘Setup new system<\/strong>‘ button to continue.<\/p>\n
![\"Start](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-5.png\" "\\"\\"")
<\/a><\/p>\nNow fill all the admin configuration. Username, email address, and password, and then click ‘Create<\/strong>‘.<\/p>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-6.png\" "\\"\\"")
<\/a><\/p>\nFor organization name, type your company name and click ‘Next<\/strong>‘.<\/p>\n
![\"Set](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-7.png\" "\\"\\"")
<\/a><\/p>\nFor email notification, click ‘Continue<\/strong>‘.<\/p>\n
We can do the Email Notification configuration from the settings page.<\/p>\n
![\"Email](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-8.png\" "\\"\\"")
<\/a><\/p>\nFor channel configuration, click ‘Skip<\/strong>‘.<\/p>\n
![\"Channel](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-9.png\" "\\"\\"")
<\/a><\/p>\nAnd now you see the Zammad admin dashboard with beautiful UI.<\/p>\n
![\"Zammad](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/02\/how-to-install-zammad-ticketing-system-on-centos-7-10.png\" "\\"\\"")
<\/a><\/p>\n