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

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 сервис у облаку.

Да бисте пратили кораке инсталације испод, потребни су алати као што су цурл, гнупг и други. Ако их нема на вашем систему, инсталирајте их:

sudo apt install curl apt-transport-https gnupg

Zammad uses jemalloc as memory allocator out of the box on Debian, Ubuntu, CentOS and RHEL. For SLES, opt-out and verification details, see the Memory allocator page.

Основе

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

List your current locale settings:

locale | grep "LANG="

If above does not return <lang_code>.utf8, you can correct this issue as follows:

sudo apt install locales

sudo locale-gen en_US.UTF-8

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

After fixing it, make sure to check the output again for including <lang_code>.utf8. A reboot may help if unsuccessful.

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

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

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

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

INFO

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

Додајте кључ репозиторија:

sudo curl -fsSL "https://go.packager.io/srv/deb/zammad/zammad/gpg-key.gpg" \
  -o /usr/share/keyrings/zammad.gpg && sudo chmod 644 /usr/share/keyrings/zammad.gpg

Додајте репозиториј (Ubuntu 22.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/22.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Додајте репозиториј (Ubuntu 24.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/24.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

Додајте репозиториј (Ubuntu 26.04):

sudo curl -fsSL "https://go.packager.io/srv/zammad/zammad/stable/installer/ubuntu/26.04.list" \
  -o /etc/apt/sources.list.d/zammad.list

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

sudo apt update

sudo apt install zammad

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

Zammad користи три сервиса. Њима се може управљати појединачно или одједном преко надређеног zammad процеса.

• заммад: укључује следеће сервисе
  • zammad-web: интерни puma сервис (одговоран за приказ веб апликације)
  • zammad-worker: позадински процес – одговоран за извршавање свих одложених и задатака у позадини
  • zammad-websocket: WebSocket сервис за информације о сесији

Управљајте сервисима командама start, restart, stop, status програма systemctl.

Пример за покретање Zammad-а са свим под-сервисима:

systemctl старт заммад

Да бисте зауставили или поново покренули сервис или проверили његов статус, прилагодите команду како је наведено горе.

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

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

Предуслови

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

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

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

Zammad чува свој садржај у бази података. Подржани систем база података је PostgreSQL 15 или новији. Ако PostgreSQL сервер није детектован, биће аутоматски инсталиран током инсталације пакета.

WARNING

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

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

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

• Nginx
• Apache

Скрипт за инсталацију покушава да детектује Apache или Nginx током инсталације. У случају да ниједан није пронађен, Nginx се аутоматски инсталира. Основан пример можете наћи у нашем водичу за конфигурацију web сервера.

Redis

За комуникацију у реалном времену преко web сокета потребан је Redis. Zammad захтева Redis 7 или новији. Аутоматски се инсталира (пакет) или је укључен у стацк-у (Docker Compose) са радном конфигурацијом. Међутим, инсталација и конфигурација су изван опсега ове документације. Пратите званичне водиче и осигурајте да га поставите на сигуран начин.

Доступне променљиве окружења за стандардна и Sentinel подешавања су кратко поменуте на страници Redis Варијабле.

INFO

CentOS и RHEL 10 користе Valkey као замену за Redis. Током инсталације Zammad-а на тим дистрибуцијама, аутоматски се инсталира као завистан пакет.

Elasticsearch opciono toplo preporučeno

Elasticsearch се не инсталира аутоматски. Пошто је кључан за исправно подешавање Zammad-а, укључен је у горе наведена упутства за инсталацију. Ако желите да повежете Zammad са већ постојећом Elasticsearch инстанцом, проверите да ли користите подржану верзију и погледајте наш пример конфигурације.

Подржане Elasticsearch верзије су 8.11 - 9.x.

Историјат Elasticsearch верзије за Zammad:

Details

Zammad	Elasticsearch
7.2+	>= 8.15, <10
7.0-7.1	>= 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

Memcached

Zammad се у великој мери ослања на кеширање за побољшање перформанси. Овај кеш може бити сачуван у фајл систему без ослањања на екстерне сервисе. Међутим, ово је могуће само ако сви Zammad-ови сервиси раде на истом фајл систему!

У свим осталим случајевима попут деплоувања Zammad-а путем контејнера (Docker или Kubernetes) или на одвојеним чворовима кластера, потребан је Memcached сервис за чување кеша и ислуживање свим Zammad инстанцама. Docker и Kubernetes стацк-ови већ укључују овај сервис.

Међутим, чак и локалне инсталације на фајл систему могу имати користи од Memcached-ових побољшања перформанси. Такође бисте могли погледати нашу секцију подешавање перформанси.

Инсталација и конфигурација су изван опсега ове документације. У случају да морате ручно инсталирати Memcached, пратите званичну документацију Memcached-а.

GnuPG opciono

Ако желите да користите PGP интеграцију за слање и примање потписаних и шифрованих емаилова, морате инсталирати GnuPG-алат. Погледајте званичну GnuPG веб страницу.