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)

About

• Zammad

Prerequisites

• Software
  • 1. Client requirements
  • 2. Server requirements
• Hardware
  • For Zammad and a database server like PostgreSQL we recommend at least:
  • For optimal performance up to 40 agents:
  • Performance Tuning

Installation & Update

• Install from package
• Install from source
• Set up Elasticsearch
• Install with Docker Compose
• Install on Kubernetes via Helm
• Updating Zammad

Getting started

• Configure the webserver
  • Get a ssl certificate (recommended)
  • Adjusting the webserver configuration
• First steps
  • Getting Started Wizard
  • Further Steps

Migration

• Migrating to Zammad

Administration via ...

• Web-UI
• Console
  • Start Zammad’s Rails console
  • Working on the console

Contributing / Development

• Start
  • Zammad Source Code
  • Documentation
  • Translation

REST API

• Introduction
  • API clients
  • Authentication
  • Endpoints and example data
  • Content Type
  • Response Payloads (expand)
  • Pagination
  • Sorting search results
  • Actions on behalf of other users
  • Encoding
• User
  • me - current user
  • List
  • Search
  • Show
  • Create
  • Update
  • Delete
• Organization
  • List
  • Search
  • Show
  • Create
  • Update
  • Delete
• Group
  • List
  • Show
  • Create
  • Update
  • Delete
• Roles
  • List
  • Show
  • Create
  • Update
• Calendar
  • List
  • Show
  • Create
  • Update
  • Delete
• Service-Level Agreements (SLA)
  • List
  • Show
  • Create
  • Update
  • Delete
• Ticket Endpoints
  • Articles
  • Linking Tickets
  • Mentions
  • Priorities
  • Shared Drafts
  • States
  • Tags
  • Tickets
  • Time Accounting
• Generic CTI
• Online Notification
  • List
  • Show
  • Update
  • Delete
  • Mark all as read
• Object
  • List
  • Show
  • Create
  • Update
  • Delete
  • Execute Database Migrations
• User Access Token
  • List
  • Create
  • Delete

Appendix

• Backup and Restore
  • Getting Started
  • Limitations
• Configuration via Environment Variables
  • General Options
  • 🖧 Network Options
  • 🎛️ Performance Tuning
• Configure Database server
• Migrate to PostgreSQL server
  • Preparation
  • Migrate
  • Finishing
• Privacy & Data Retention
  • On-Premises Data
  • External Services
• Troubleshooting and FAQ
  • Data missing from the Web-UI / Search data missing or incomplete
• Single Sign-On for Kerberos
  • Conceptual Overview
  • Getting Started
  • Step 1: Configure Active Directory
  • Step 2: Remove NGINX, Set up Apache + Kerberos
  • Step 3: Enable SSO in Zammad
  • Step 4: Configure Client System (Windows Only)
  • Troubleshooting
• Reporting Tools (Third party)
  • Getting Started
  • Third Party Reporting Tools known to be working