Zammad nach System-Update: 500 Internal Server Error

Zammad nach System-Update: 500 Internal Server Error

ProblemGeltungsbereich

Zammad-Paketinstallation auf Debian/Ubuntu. Docker- und Source-Installationen haben andere Update- und Reparaturbefehle.

Getestetes Fehlerbild: Nach apteinem upgradeunvollständigen warSystem-/Paket-Update lieferte Zammad über den Reverse Proxy (CloudPanelHTTP →500. Zammad)In production.log fehlte application.css; teilweise waren die lokalen Zammad-Dienste auf 127.0.0.1:3000 beziehungsweise dem WebSocket-Port nicht mehrerreichbar. erreichbar.Das Fertigstellen der Paketkonfiguration und ein erneuter Asset-Build behoben den Vorfall.

Nicht generell: HTTP 500 nach einem Update hat nicht immer dieselbe Ursache. Asset-Build und Paket-Reparatur nur ausführen, wenn Paketstatus und Logs dazu passen.

Symptome

• Frontend:

The asset "application.css" is not present in the asset pipeline

• Nginx:

Root1. CauseUrsache eingrenzen

UnvollständigesNicht oderzuerst fehlerhaftesden Paket-Reverse Proxy ändern. Zuerst Paketstatus, Dienste und lokale Anwendung prüfen:

sudo dpkg --audit
sudo systemctl status zammad zammad-web zammad-worker zammad-websocket --no-pager
sudo journalctl -u zammad -u zammad-web -u zammad-worker -u zammad-websocket -n 100 --no-pager
sudo tail -n 100 /Asset-Upgradevar/log/zammad/production.log
nachcurl System-fsS Update.
-o Rails/DB/dev/null liefen,-w aber'%{http_code}\n' Frontendhttp://127.0.0.1:3000/
Assets

Interpretation:

2. Vor Änderungen sichern

Zammad empfiehlt vor Updates ein vollständiges Backup gemäss der offiziellen Backup-Dokumentation, ausserdem Release Notes lesen und keine Hauptversionen überspringen.

Lösung3. Unterbrochene Paketkonfiguration fertigstellen

Zammad stoppen, damit Datenbank- und Asset-Schritte nicht gegen laufende Dienste laufen:

sudo systemctl stop zammad
sudo apt update
sudo apt --fix-broken install
sudo dpkg --configure -a
sudo

apt full-upgrade -y cdist /opt/zammadkein pauschaler Reparaturschritt; es gehört in einen separat geprüften Wartungsplan.

4. Assets nur bei bestätigtem Asset-Fehler neu bauen

Aktuelle Zammad-Pakete führen ihre Migrations- und Precompile-Schritte normalerweise selbst aus. Der Paket-Precompile-Task bereitet auch die JavaScript-Umgebung vor und ruft anschliessend assets:precompile auf. Deshalb den übergeordneten Paket-Task verwenden:

sudo zammad run rake zammad:package:precompile

Nicht standardmässig direkt rake assets:precompile ausführen; der Paket-Task bildet die aktuelle Postinstall-Logik vollständiger ab.

Schlägt der Task fehl, die Fehlermeldung sichern und insbesondere Paketstatus, Node/pnpm-Umgebung und Datenbankerreichbarkeit prüfen.

5. Starten und validieren

sudo systemctl start zammad
sudo systemctl restartstatus zammad zammad-web zammad-worker zammad-websocket nginx--no-pager

Validierung

-o /dev/null -w '%{http_code}\n' http://127.0.0.1:3000/
sudo du -sh /opt/zammad/public/assets
sudo tail -n 50100 /var/log/zammad/production.loglslog

Erst danach den öffentlichen URL-Pfad testen und bei Bedarf Nginx-Config prüfen:

sudo nginx -laht
/opt/zammad/public/assetssudo |systemctl grepreload applicationnginx

Root Cause in diesem Vorfall

Das System-Update liess die Zammad-Paketkonfiguration unvollständig zurück; Rails und Datenbank liefen, aber die Frontend-Assets waren nicht korrekt gebaut. Der Reverse Proxy war nicht die Ursache.

Prävention

Zammad empfiehlt für Paketinstallationen folgende Reihenfolge, insbesondere wenn Zammad und das Betriebssystem zusammen aktualisiert werden:

Beispiel gemäss Herstellerablauf:

sudo systemctl stop zammad
sudo apt update
sudo apt-mark hold zammad
sudo apt upgrade
sudo apt-mark unhold zammad
sudo apt upgrade

Lessons Learned

• Reverse Proxy war NICHT Root Cause

PräventionQuellen

Vor

aptZammad update(Paketinstallation)

Quelle: Obsidian Knowledge Base/Troubleshooting/Zammad nach System Update 500 Internal Server Error.md · Stand: 2026-05-1710-12 · Automatisiert publiziert durch Hermes.