Skip to content

Latest commit

 

History

History
135 lines (80 loc) · 2.55 KB

install-debian.rst

File metadata and controls

135 lines (80 loc) · 2.55 KB
Raw

Install on Debian via DEB

Currently we support Debian 8 and 9

Prerequisites

Be sure to use an UTF-8 locale or PostgreSQL will not install.

Setup Elasticsearch

https://docs.zammad.org/en/latest/install-elasticsearch.html

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

/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