Troubleshooting & Fehlerbehebung

Lösungen für häufig auftretende Probleme.

502 Bad Gateway

Problem: Website zeigt "502 Bad Gateway"

Ursachen: Gunicorn läuft nicht, falscher Port, Konfigurationsfehler

Lösung:

# 1. Service Status prüfen
sudo systemctl status helpdesk
sudo systemctl status helpdesk-web

# 2. Service neu starten
sudo systemctl restart helpdesk

# 3. Logs prüfen
tail -f /var/www/helpdesk/logs/gunicorn-error.log
sudo journalctl -u helpdesk -n 50 -e

# 4. Port erreichbar?
curl http://127.0.0.1:8000

# 5. Manuelle Gunicorn-Test
cd /var/www/helpdesk
source venv/bin/activate
gunicorn --bind 127.0.0.1:8000 helpdesk.wsgi:application

Static Files nicht geladen (404)

Problem: CSS, JS und Bilder werden nicht geladen

Ursachen: Falsche Pfade, fehlende Berechtigungen, nicht gesammelt

Lösung:

# 1. Static Files neu sammeln
cd /var/www/helpdesk
source venv/bin/activate
python manage.py collectstatic --clear --noinput

# 2. Berechtigungen prüfen
ls -la staticfiles/
sudo chown -R helpdesk:helpdesk staticfiles/
sudo chmod -R 755 staticfiles/

# 3. Web Server Konfiguration prüfen
# Nginx: Alias korrekt?
# Apache: Alias korrekt?

# 4. Service neu starten
sudo systemctl restart nginx
# oder
sudo systemctl restart apache2

Datenbank-Fehler

Problem: "no such table" oder Verbindungsfehler

Ursachen: Datenbank läuft nicht, Migrationen nicht durchgeführt

Lösung:

# 1. MySQL läuft?
sudo systemctl status mysql
sudo systemctl start mysql

# 2. Verbindung testen
mysql -u helpdesk_user -p helpdesk_db

# 3. Migrationen durchführen
cd /var/www/helpdesk
source venv/bin/activate
python manage.py migrate

# 4. .env überprüfen
grep DATABASE_URL .env

Email funktioniert nicht

Problem: SMTP-Fehler oder Email wird nicht versendet

Ursachen: Falsche Credentials, Port blockiert, TLS-Problem

Lösung:

# 1. Credentials prüfen
grep EMAIL .env
grep SMTP .env

# 2. SMTP-Verbindung testen
telnet smtp.office365.com 587

# 3. Django-Test
python manage.py shell
>>> from django.core.mail import send_mail
>>> send_mail('Test', 'Test', '[email protected]', ['[email protected]'])

# 4. Admin-Panel Test
# Admin-Panel → Einstellungen → Email → Test

# 5. Logs prüfen
sudo journalctl -u helpdesk -e | grep -i email

Häufige Fehler:

• Office 365: App-Passwort verwenden, nicht Konto-Passwort
• Gmail: 2FA aktivieren und App-Passwort erstellen
• Port 587: TLS verwenden, nicht SSL
• Port 465: SSL verwenden (implizites Encryption)

SSL/TLS-Fehler

Problem: "Certificate not found" oder abgelaufenes Zertifikat

Lösung:

# 1. Let's Encrypt-Zertifikat erstellen
sudo certbot --nginx -d beispiel.de -d www.beispiel.de
# oder
sudo certbot --apache -d beispiel.de -d www.beispiel.de

# 2. Auto-Renewal aktivieren
sudo systemctl enable certbot.timer
sudo systemctl start certbot.timer

# 3. Renewal testen
sudo certbot renew --dry-run

# 4. Zertifikat manuell erneuern
sudo certbot renew

# 5. Zertifikat überprüfen
sudo certbot certificates

Permission Denied (Dateien)

Problem: "Permission denied" bei Upload oder Logs

Ursachen: Falsche Besitzer oder Berechtigungen

Lösung:

# Für Nginx:
sudo chown -R helpdesk:helpdesk /var/www/helpdesk/media
sudo chmod -R 775 /var/www/helpdesk/media
sudo chmod -R 775 /var/www/helpdesk/logs

# Für Apache:
sudo chown -R www-data:www-data /var/www/helpdesk/media
sudo chmod -R 775 /var/www/helpdesk/media

# Für ISPConfig:
sudo chown -R web:client /var/www/clients/client/web/helpdesk/media
sudo chmod -R 775 /var/www/clients/client/web/helpdesk/media

Virtual Environment Probleme

Problem: "No module named django" oder Paket nicht gefunden

Ursachen: Virtual Environment nicht aktiviert, Pakete nicht installiert

Lösung:

# 1. Virtual Environment aktivieren
cd /var/www/helpdesk
source venv/bin/activate

# 2. Pakete neu installieren
pip install -r requirements.txt

# 3. Installation prüfen
python -c "import django; print(django.__version__)"

# 4. Virtual Environment neu erstellen (falls korrupt)
rm -rf venv
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

High Memory Usage

Problem: Server wird langsam oder Out-of-Memory

Ursachen: Zu viele Gunicorn Worker, Memory Leak

Lösung:

# 1. Memory prüfen
free -h
ps aux | grep gunicorn

# 2. Worker reduzieren
# In service file:
--workers 2  # statt 4

# 3. Worker Memory Limit
--max-requests 1000
--max-requests-jitter 100

# 4. Service neu starten
sudo systemctl restart helpdesk

Connection Refused / Port in Use

Problem: "Connection refused" oder Port bereits in Benutzung

Lösung:

# 1. Wer nutzt den Port?
sudo lsof -i :8000
sudo netstat -tlnp | grep 8000

# 2. Prozess killen
sudo kill -9 

# 3. Oder anderen Port nutzen
# In service file:
--bind 127.0.0.1:8001

# 4. Service neu starten
sudo systemctl restart helpdesk

ISPConfig: Nginx Directives werden nicht angewendet

Problem: Änderungen in ISPConfig haben keine Wirkung

Lösung:

# 1. ISPConfig: Speichern Sie erneut
# Admin-Panel → Websites → Website → Options → Save

# 2. Nginx-Syntax prüfen
sudo nginx -t

# 3. Nginx neu laden
sudo systemctl reload nginx

# 4. Browser-Cache leeren
# Ctrl+Shift+Delete in Browser

# 5. Logs prüfen
sudo tail -f /var/log/nginx/error.log

Logs sind zu groß

Problem: Log-Datei mehrere GB groß

Lösung:

# 1. Alte Logs löschen
rm /var/www/helpdesk/logs/*.log

# 2. Logrotate konfigurieren
sudo nano /etc/logrotate.d/helpdesk

Inhalt:

/var/www/helpdesk/logs/*.log {
    daily
    rotate 7
    compress
    delaycompress
    notifempty
    create 0640 helpdesk helpdesk
    sharedscripts
}

# 3. Test
sudo logrotate -f /etc/logrotate.d/helpdesk

Wichtigste Debugging-Befehle

# Service Status
sudo systemctl status helpdesk
sudo systemctl restart helpdesk

# Logs ansehen
tail -f /var/www/helpdesk/logs/gunicorn-error.log
sudo journalctl -u helpdesk -f

# Django Shell für Tests
cd /var/www/helpdesk
source venv/bin/activate
python manage.py shell

# Datenbank testen
python manage.py dbshell

# System-Ressourcen
free -h
df -h
ps aux | grep gunicorn

© 2025 ABoro-Soft - Troubleshooting Guide