zammad auf neue Domain umziehen

Problem

Nach dem Umzug einer Zammad-Installation auf eine neue Domain bleibt die ursprüngliche Adresse in der Konfiguration hinterlegt. Dadurch werden beispielsweise Links in Benachrichtigungsmails weiterhin mit der alten Domain generiert, manchmal gibt es sogar eine Fehlermeldung

Lösung

Die hinterlegte Domain lässt sich über die Rails-Konsole korrigieren. Dazu am entsprechenden Server anmelden (ssh, Konsole, et cetera).

1. Rails-Konsole öffnen

zammad run rails c

2. Aktuelle Domain prüfen

Setting.get('fqdn')

Das könnte z.B. so aussehen:

=> "support.alt-domain.de"

3. Neue Domain setzen
Die alte Domain ersetzen mit dem folgenden Befehl

Setting.set('fqdn', 'tickets.neue-domain.de')

Die Rückgabe true bestätigt die erfolgreiche Änderung.

4. Änderung überprüfen

Setting.get('fqdn')

Die Änderung ist sofort wirksam. Ein Neustart von Zammad ist normalerweise nicht erforderlich.