Skip to content

Latest commit

 

History

History
139 lines (83 loc) · 2.85 KB

install-debian.rst

File metadata and controls

139 lines (83 loc) · 2.85 KB
Raw

Install on Debian via DEB

Note

Currently we support Debian 8 and 9

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: :ref:`install_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

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