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

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.

• Обезбедите најмање 4 GB RAM за контејнере.

• Подесите ваш сервер да правилно извршава 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-а

The Zammad Docker Compose stack is ready to run with its default settings. You can adapt it to your environment by loading predefined scenario files, adjusting environment variables and adding files specific to your instance.

See the Docker Compose scenarios page for supported use cases and detailed instructions on loading scenario files. To change individual settings, use Docker specific environment variables.

If you deployed the stack with Docker Compose by cloning the repository, use its local/ directory for files that belong only to your instance. See the customize the stack locally section for details.

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