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

Zammad се може покренути преко Docker Compose. Можете чак користити и графички интерфејс за Docker као што је Portainer.

INFO

Не пружамо техничку подршку у вези проблема са Docker (Compose) или Portainer инсталацијама. Уколико одлучите да користите Zammad путем Docker-а, подршка је могућа само за Zammad апликацију.

Предуслови

• Make sure your Docker Compose setup matches the requirements you can find in the README of Zammad's Docker Compose repository.

• Make sure to have at least 4 GB of RAM to run the containers.

• Подесите ваш сервер да правилно извршава Elasticsearch сервис:

  sudo sysctl -w vm.max_map_count=262144

Покретање преко Docker Compose

Корак 1: Клонирање GitHub репозиторија

git clone https://github.com/zammad/zammad-docker-compose.git

Обавезно често извршавајте git pull команду за ажурирање. Алтернативно, можете преузети датотеке са странице издања.

Корак 2: Подешавање окружења по потреби

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

Корак 3: Покретање stack-а

cd zammad-docker-compose

docker compose up -d

Optional: Use an additional .yml file to use a pre-defined scenario. Read on in the Customizing the Zammad Stack section.

Након што је stack спреман, можете приступити Zammad-у преко подешеног Docker хоста и порта, нпр. http://localhost:8080/.

Покретање преко Portainer-а

Најлакши начин да покренете Zammad је преко графичког Docker интерфејса. Препоручујемо Portainer. За упутство инсталације, погледајте званичну Portainer документацију.

Корак 1: Додавање stack-а

У графичком интерфејсу Portainer-а (нпр. https://yourdomain.tld:9443), идите на циљно окружење, одаберите Stacks и кликните на Add stack као на снимку екрана испод.

Корак 2: Инсталација из репозиторија

Пребаците се на метод изградње Репозиторијум и унесите информације испод:

• Име: унесите жељено име стацк-а
• URL адреса репозиторија: https://github.com/zammad/zammad-docker-compose
• Референца repo-зиторијума: refs/heads/master
• Путања Compose-а: docker-compose.yml (подразумевано)

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

Корак 3: Покретање stack-а

Finally, click the Deploy the stack button. The first time, it may take some time until the Docker images are fetched.

Након што је stack спреман, можете приступити Zammad-у преко подешеног Docker хоста и порта, нпр. http://localhost:8080/.

Излагање стацк-а преко HTTPS-а

To publish a Zammad stack on the internet, it needs to be secured via the HTTPS protocol. To achieve that without modifying the Zammad stack, you can:

• Користите реверзни прокси као што је Nginx Proxy Manager (NPM). Он има GUI који омогућава једноставну интеграцију са Let'с Encrypt.
• Користите Cloudflare тунел, који пружа SSL терминацију.

Оба сценарија су објашњена на одвојеној страници Docker Compose Scenarios.

Прилагођавање Zammad stack-а

Zammad стацк се може прилагодити учитавањем додатних фајлова са сценаријима за честе случајеве употребе. На пример, можете деплоуовати стацк са укљученим Nginx Proxy Manager-ом (NPM) или са онемогућеним PostgreSQL или Elasticsearch сервисима, ако већ имате те сервисе у раду.

Молимо погледајте страницу Сценарији за Docker Compose.

За подешавање стацк-а и поставки користите Docker специфичне променљиве окружења.

Извршавање команди у stack-у

Покрените команде у вашем Docker стацк-у тако што ћете позвати rails или rake путем једне од следећих метода користећи bundle exec.

Директно извршите одређену команду:

docker compose run --rm zammad-railsserver bundle exec rails r '...your rails command here...'

Покрените интерактивну Rails конзолу да бисте ручно унели Rails команде:

docker compose run --rm zammad-railsserver bundle exec rails c

Преко docker compose exec:

docker compose exec zammad-railsserver bundle exec rails r '...your rails command here...'

TIP

Уколико желите да добијете информације од вашег rails сервера, можете, нпр. да укључите pp (pretty print) испред ваших rails команди. Ово ће довести до излаза на вашем терминалу.