Install with Docker Compose¶
Warning
We currently do not support Docker environments in productive use. It’s no problem if you run Zammad on docker, however, support is only provided for Zammad as application!
Note
Docker Compose environments require deeper system know how. If you’re not too familiar with Docker and the way it works, you may want to stick with the package installation instead.
Docker is a container-based software framework for automating deployment of applications. Compose is a tool for defining and running multi-container Docker applications.
Zammads docker images are hosted on Dockerhub.
Warning
Never use the latest
tag. Use a tag which has a version attached.
You need at least 4 GB of RAM to run the containers.
Install Docker Environment¶
This documentation expects you already have a working Docker Compose environment. You can find the required documentations for these steps below:
Getting started with zammad-docker-compose¶
Step 1: Clone GitHub repo¶
Warning
If you’re updating Zammad, below commands will cause values set in .env
and docker-compose.override.yml
to be lost. You’re expected to check
if the docker-compose.yml
has changed and if so to adjust it accordingly.
$ git clone https://github.com/zammad/zammad-docker-compose.git
$ cd zammad-docker-compose
Hint
If cloning is too much of a hassle, it’s also enough to get the files
docker-compose.yml
and .env
.
Step 2: Setting vm.max_map_count for Elasticsearch¶
Even with running Elasticsearch in a container, you’re required to adjust your host’s settings to ensure a clean runtime.
$ sysctl -w vm.max_map_count=262144
Step 3: Adjust Environment as needed¶
In some cases our default environment is not what a docker-compose user is looking for. To remove complexity from this page, we outsourced information on this topic.
Step 4: Start Zammad using DockerHub images¶
Warning
Before starting your containers ensure to not use default login data for your Zammad database! See Step 3!
$ docker compose up -d
Next steps¶
With this Zammad technically is ready to go. However, you’ll need to follow the following further steps to access Zammads Web-UI and getting started with it.
You may also find Zammads Console commands useful
If you expect usage with 5 agents or more you may also want to consider the following pages.