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

TIP

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

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

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

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

Дистрибуција	Верзија
CentOS/RHEL	8 и 9
Debian	11 и 12
OpenSUSE/SLES	Leap 15.x / 15
Ubuntu	20.04, 22.04, 24.04

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

Да бисте испратили инсалационе кораке испод, може бити неопходно да инсталирате додатне алате као curl, gnupg и остале.

Required Tools

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 20.04

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 20.04 main"| \
sudo tee /etc/apt/sources.list.d/zammad.list > /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 користи три сервиса. Они могу бити (ре)стартовани и стопирани за основним zammad процесом:

systemctl (status|start|stop|restart) zammad

Само интерни puma сервис (одговоран за приказ веб апликације):

systemctl (status|start|stop|restart) zammad-web

Само позадински процес - одговоран за извршавање свих одложених и задатке у позадини:

systemctl (status|start|stop|restart) zammad-worker

Само websocker сервис за информације о сесији:

systemctl (status|start|stop|restart) zammad-websocket

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

• Повежите 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 10 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.

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 - 8.x.

Elasticsearch version history

Zammad	Elasticsearch
5.2+	>= 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.