Installs and configures a Zammad server. Zammad is a web-based, open source user support/ticketing solution.
- Chef 12.5+
- RHEL 7+
Notes: This cookbook has been tested on the listed platforms. It may work on other platforms with or without modification.
- Elasticsearch
- Java
- Nginx
- Postfix
- Sysctl
- Yum-EPEL
Linux default attributes
node['java']['jdk_version']- Java version, default 'OpenJDK 8'node['postfix']['main']['relayhost']- Relayhost for Postfix when default['zammad']['local_mta'] = true, default 'smtp.example.com'node['zammad']['local_mta']- Setup a local Postfix MTA for Zammad, default 'true'node['zammad']['local_es']- Setup a local Elasticsearch for Zammad, default 'true'node['zammad']['use_proxy']- Use the Chef http_proxy when downloading ES plugins, default 'false'node['zammad']['nginx_server_name']- Server name to use in the Nginx zammad.conf file, default 'localhost'
Includes the zammad::elasticsearch and/or postfix recipes depending on whether they are enabled via attributes.
Configures the node to run elasticsearch locally. Generates a generic ES setup based on the defaults in the Elasticsearch cookbook. It also runs two rake commands to complete the ES setup for Zammad.
The default recipe will:
- Setup Zammad Repo
- Install Java
- Install Nginx and deploy a default zammad.conf from the template
- Install Zammad
- Install and setup an Elasticsearch cluster, optional
- Install and setup Postfix MTA, optional
If you want to install the default Elasticsearch cluster, set the default['zammad']['local_es'] to true. Use of an exteral Elasticsearch server is supported but currently out of the scope of this cookbook.
If you want to setup the local Postfix MTA for Zammad to use, set the default['zammad']['local_mta'] to true. If you'd rather setup Zammad to use an external SMTP server, set this to false.