Getting Started Wizard - Couldn't add SMTP channel or local MTA


  • Used Zammad version: 5.4.0
  • Used Zammad installation type: docker-compose
  • Operating system: Ubuntu 22.04
  • Browser + version: Firefox 110.0.1

Expected behavior:

  • SMTP (Credentials): Able to log in using GMail username and password
  • SMTP (App Password): Able to log in using GMail username and app password
  • Local MTA: Set outgoing email using sendmail and continue the Getting Started Wizard

Actual behavior:

  • SMTP (Credentials): Kept getting “auth failed” even tho the credentials are correct. Most probably due to OAuth, but I don’t see any way to use OAuth during this stage

  • SMTP (App Password): Received “syntax error” message

  • Local MTA: Missing /usr/bin/sendmail


Steps to reproduce the behavior:

  • Spin up new docker compose instance
  • Go through the Getting Started Wizard
  • Choose either Local MTA or SMTP (with GMail) during “Email Notification” setup
  • You will stuck at this stage…

Basic Auth on Gmail via IMAP and SMTP are not supported by Google and require XOAUTH. Notification channels do not support Gmail and Microsoft 365 for this reason (see at the bottom: Accounts — Zammad Admin Documentation documentation )

During Getting started when asked to provide a notification channel configuration there’s actually a “Skip” button allowing you to continue without configuring for the time being.

Zammad tells you what the issue is. Install any dependency of sendmail to solve this. E.g. Postfix.

This topic was automatically closed 360 days after the last reply. New replies are no longer allowed.