Install on Debian via DEB¶
Note
Currently we support Debian 8, 9 and 10
Prerequisites¶
Be sure to use an UTF-8 locale or PostgreSQL will not install.
Setup Elasticsearch¶
Elasticsearch is a dependency of Zammad and needs to be provided before installing Zammad. Please take a look at the following page: Set up Elasticsearch .
Check locale¶
$ locale
If there is nothing with UTF-8 in the name shown like “LANG=en_US.UTF-8” you have to set a new locale.
Set locale¶
$ sudo apt-get install apt-transport-https locales sudo wget
$ sudo locale-gen en_US.UTF-8
$ sudo echo "LANG=en_US.UTF-8" > /etc/default/locale
Add Zammad DEB repo and install¶
$ wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
For Debian 8¶
$ sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/debian/8.repo
For Debian 9¶
$ sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/debian/9.repo
For Debian 10¶
$ sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/debian/10.repo
$ sudo apt-get update
$ sudo apt-get install zammad
Go to http://localhost and you’ll see:¶
- “Welcome to Zammad!”, there you need to create your admin user and invite other agents.
Change your webserver configuration (non localhost connections):¶
Add your fully qualified domain name or public IP to server name directive in your web server configuration and restart your web server. The installer will give you a hint where Zammad’s web server config file is located.
nginx¶
Warning
Please do not rename the webserver config file for nginx or apache. The update process will re create it, if it does not exist!
# /etc/nginx/sites-enabled/zammad.conf
server {
listen 80;
# replace 'localhost' with your fqdn if you want to use zammad from remote
server_name localhost;
You can manage the Zammad services manually:¶
Zammad¶
$ sudo systemctl status zammad
$ sudo systemctl stop zammad
$ sudo systemctl start zammad
$ sudo systemctl restart zammad
only web application server¶
$ sudo systemctl status zammad-web
$ sudo systemctl stop zammad-web
$ sudo systemctl start zammad-web
$ sudo systemctl restart zammad-web
only worker process¶
$ sudo systemctl status zammad-worker
$ sudo systemctl stop zammad-worker
$ sudo systemctl start zammad-worker
$ sudo systemctl restart zammad-worker
only websocket server¶
$ sudo systemctl status zammad-websocket
$ sudo systemctl stop zammad-websocket
$ sudo systemctl start zammad-websocket
$ sudo systemctl restart zammad-websocket