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

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 адресама, тако да имајте ово на уму приликом извршавања корака испод.

Инсталирајте кључ репозиторија:

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

echo "deb [signed-by=/etc/apt/keyrings/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/ubuntu 24.04 main"| \
   sudo tee /etc/apt/sources.list.d/zammad.list > /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 ће снимати сав садржај у базу података. Подржавамо PostgreSQL верзије 10 и навише. Инсталациона скрипта ће покушати да детектује MySQL/MariaDB или PostgreSQL сервис приликом инсталације. У случају да не буде пронађен, PostgreSQL ће бити аутоматски инсталиран.

WARNING

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

Уколико још увек користите MySQL/MariaDB, требало би да мигрирате на PosgreSQL. Подршка за MySQL/MariaDB ће бити избачена почевши са Zammad 7.

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

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

• 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 configuration guide here.

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 optional

Instead of storing Zammads cache files within your filesystem, they can be cached in memory with Memcached.

The installation and configuration is out of our scope of this documentation. Please follow the official guides.

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.