Инсталација пакета

TIP

Да ли сте преуморни од комплексних поставки, подешавања, резервних копија и ажурирања? Дозволите нам да вам помогнемо око тога! 🚀

Најлакши и најчешће најјефтинији начин да имплементирате Zаmmad је наш сервис у облаку. Уверите се преко бесплатне пробне инстанце!

Подржани оперативни системи

За инсталацију пакета, подржане су следеће дистрибуције Linux платформе:

Distribution	Version
CentOS/RHEL	8 & 9
Debian	11 & 12
OpenSUSE/SLES	Leap 15.x / 15
Ubuntu	22.04, 24.04

Уколико ваша дистрибуција тренутно није подржана, пробајте други метод инсталације или размотрите претплату на Zammad сервис у облаку.

To follow the installation steps below, tools like curl, gnupg and others are required. If they are not present on your system, install them:

sudo apt install curl apt-transport-https gnupg

Основе

Обезбедите исправан locale

Излистајте ваша тренутна locale подешавања:

locale | grep "LANG="

Уколико горња команда не врати <lang_code>.utf8, ово можете исправити на следећи начин:

sudo apt install locales

sudo locale-gen en_US.UTF-8

echo "LANG=en_US.UTF-8" > sudo /etc/default/locale

Након промене, обавезно поново излистајте подешавање и проверите да ли враћа <lang_code>.utf8. Уколико буде неуспешно, рестартовање може помоћи.

Elasticsearch инсталација

Препоручени метод је да користите званичан Elastic водич за инсталацију Elasticsearch.

Алтернативно, можете погледати наш пример за Elasticsearch 7, који се налази на посебној страници да би упутство остало што прегледније.

Додајте Zammad репозиториј

INFO

Packager.io можда није доступан из окружења са искључиво IPv6 адресама, тако да имајте ово на уму приликом извршавања корака испод.

Install repository key:

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | sudo tee /etc/apt/keyrings/pkgr-zammad.gpg> /dev/null

Ubuntu 22.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 22.04 main"| \
sudo tee /etc/apt/sources.list.d/zammad.list > /dev/null

Ubuntu 24.04

INFO

Starting with Ubuntu 24.04, we provide the command to add the repository in the deb822 format.

printf "Types: deb
URIs: https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu
Suites: 22.04
Components: main
Signed-By: /etc/apt/keyrings/pkgr-zammad.gpg" | \
sudo tee /etc/apt/sources.list.d/zammad.sources > /dev/null

Инсталација Zammad-а

sudo apt update

sudo apt install zammad

Управљање Zammad сервисима

Zammad uses three services. These services can be managed individually or all at once by using the parent zammad.

• zammad: includes the services below
  • zammad-web: internal puma server (relevant for displaying the web app)
  • zammad-worker: background worker - relevant for all delayed- and background jobs
  • zammad-websocket: websocket server for session related information

Manage the services with systemctl's commands start, restart, stop, status.

Example to start Zammad with all sub-services:

sudo systemctl start zammad

To stop or restart a service or to check its status, adjust the command as mentioned above.

Следећи кораци

• Повежите Zammad са Elasticsearch (основни водич)
• Подесите ваша SELinux правила и firewall (основни водич)
• Подесите веб сервис (основни водич)

Предуслови

Под претпоставком да систем није прилагођен, следећи предуслови ће бити аутоматски инсталирати приликом инсталације Zammad пакета. Додатно, испод можете пронаћи неке информације о Elasicsearch, који неће бити аутоматски инсталиран.

• imlib2
• Node.js
• PostgreSQL
• Nginx
• Redis

Сервис базе података

Zammad stores its content in a database. The supported database system is PostgreSQL 13 or newer. If no PostgreSQL server could be detected, it will be installed automatically during the package installation.

WARNING

Уколико користите софтвер за организацију конекција на базу података као што је PgBouncer, обратите пажњу да користите начин организације који је потпуно подржан у оквиру PostgreSQL. Обично је под називом „session connection pooling”. Начин организација на основу трансакција није подржан и може довести до грешака приликом миграције базе података.

Прокси приступа

Следеће опције проксија приступа су подржане:

• Nginx 1.3+
• Apache 2.2+

The installation script tries to detect a Apache or Nginx during the installation. In case none is found, Nginx is automatically installed. You can find a basic example in our Webserver configuration guide.

Redis

Redis is required for realtime communication via web socket. Zammad requires Redis 6 or newer. The installation and configuration is out of scope of this documentation. Please follow the official guides and ensure to set it up in a secure way or consider another installation method or Zammad's hosting services.

Elasticsearch optional highly recommended

Elasticsearch is not automatically installed. Because it is crucial for a proper Zammad setup, it is included in the installation instructions above. If you want to connect Zammad to an already existing Elasticsearch instance, make sure to use a supported version and have a look at our config example.

Supported Elasticsearch versions are 7.8 - 9.x.

Elasticsearch version history for Zammad:

Details

Zammad	Elasticsearch
7+	>= 7.8, <10
5.2-6.5	>= 7.8, <9
5.0-5.1	>= 7.8, <8
4.0-4.1	>= 6.5, <=7.12
3.4-3.6	>= 5.5, <=7.9
3.3	>= 2.4, <=7.6
3.2	>= 2.4, <=7.5
3.1	>= 2.4, <=7.4
2.0-3.0	>= 2.4, <=5.6

The Elasticsearch plugin ingest-attachment is required for version 7 or older to index the contents of email attachments. Starting with Elasticsearch 8, it is included by default.

Memcached

Zammad heavily relies on caching to improve performance. This cache can be stored in the file system without relying on externals services. However, this is only possible if all services of Zammad are running on the same file system!

In all other cases like deploying Zammad via containers (Docker or Kubernetes) or on separate cluster nodes, a Memcached service is required to store the cache and serve it to all Zammad instances. The Docker and Kubernetes stacks already include this service.

However, even local file system installations may benefit from Memcached's performance improvements. You might want to have a look at our performance tuning section too.

The installation and configuration is out of scope of this documentation. In case you have to install Memcached manually, please follow the official documentation of Memcached.

GnuPG optional

If you want to use the PGP integration for sending and receiving signed and encrypted emails, you need to install the GnuPG-Tool. Please have a look at the official GnuPG website.