Welcome to Zammad’s documentation!

The Zammad documentation consists of three parts:

• Zammad system installation and configuration (this documentation)
• Zammad administration (https://admin-docs.zammad.org)
• Zammad user documentation (https://user-docs.zammad.org)

This system documentation for Zammad is organized into a couple of sections:

• About
• Prerequisites
• Installation & Update
• Getting started
• Migration
• Administration via console
• Contributing / Development
• REST API
• Appendix

About

• Zammad

Prerequisites

• Software
  • 1. Ruby Programming Language
  • 2. Package Dependencies
  • 3. Database Server
  • 4. Reverse Proxy
  • 5. Elasticsearch (optional)
• Hardware
  • For Zammad and a database server like PostgreSQL we recommend at least:
  • For optimal performance up to 40 agents:

Installation & Update

• Install from source (generic)
• Install from source (Debian 7, 8 / Ubuntu 16.04 / Ubuntu 18.04)
• Install from source (Mac OS 10.8)
• Install on CentOS via RPM
• Install on Debian via DEB
• Install on Ubuntu via DEB
• Install on SUSE via RPM
• Set up Elasticsearch
• Configure Zammad to work with Elasticsearch
• Install with Docker-Compose
• Install on Kubernetes via Helm
• Installation on Univention Corporate Server via App Center
• Updating Zammad

Getting started

• First steps

Migration

• from OTRS
  • Install plugins on OTRS
  • Import via Browser
  • Import via command line
  • Importing a diff
  • Restarting from scratch
• from Zendesk

Administration via webfrontend

• Admin-Documentation

Administration via console

• Console
  • Start Zammad’s Rails console
  • Working on the console

Contributing / Development

• Start
  • Source Code
  • Documentation
• Branches
  • Master
  • Develop
  • Stable
  • Stable-X.x
• Packages
• Continuous integration
  • Internal
  • External
• Code quality
  • Rubocop
  • Codeclimate
• Install with Docker
  • Run the Docker Container
  • Go to http://localhost and you’ll see:
• Install with Vagrant
  • Clone the Vagrant file
  • Run Vagrant
  • Go to http://localhost:8080 and you’ll see:
  • SSH into the machine
  • Problems starting the VM?

REST API

• Introduction
  • The API
  • Authentication
  • Request Format
  • Example CURL Requests
  • Example CURL Requests (for tickets and users)
  • Example CURL Request on behalf of a different user
  • Response Format
  • Response Format (expanded)
  • Pagination
  • API clients
• User
  • me - current user
  • List
  • Search
  • Show
  • Create
  • Update
  • Delete
• Organization
  • List
  • Search
  • Show
  • Create
  • Update
  • Delete
• Group
  • List
  • Show
  • Create
  • Update
  • Delete
• Ticket
  • List
  • Search
  • Show
  • Create
  • Update
  • Delete
• Ticket State
  • List
  • Show
  • Create
  • Update
  • Delete
• Ticket Priority
  • List
  • Show
  • Create
  • Update
  • Delete
• Ticket Article
  • By Ticket
  • Show
  • Create
• Online Notification
  • List
  • Show
  • Update
  • Delete
  • Mark all as read
• Object
  • List
  • Show
  • Create
  • Update
  • Execute Database Migrations
• Tags
  • List
  • Search
  • Add
  • Remove
  • Admin - List
  • Admin - Create
  • Admin - Rename
  • Admin - Delete
• User Access Token
  • List
  • Create
  • Delete

CTI API

• Introduction
  • Feature list
• Push API
  • How it works
  • Endpoint
  • Events

Appendix

• Backup and Restore
  • Configuration
  • Create Backup
  • Migrating from another Zammad-Host
  • Restore everything
  • What to do after restoration has been completed
• Configure environment variables
  • Configure IP
  • Configure ports
  • Application Servers
  • Configure Restart Command
  • Configure Zammad to log to STDOUT
• Package Repo Files
  • CentOS 7
  • Debian 8
  • Debian 9
  • Ubuntu 16.04
  • Ubuntu 18.04
  • SLES 12
  • Note
• Privacy & Data Retention
  • On-Premises Data
  • External Services