Häufig gestellte Fragen (FAQ)

Antworten auf die am häufigsten gestellten Fragen zur Installation und Verwendung des Helpdesk-Systems.

---

Installation & Setup

F: Welche Installation passt zu mir?

A:

• ISPConfig + Nginx: Sie haben ein ISPConfig Panel und mögen Nginx (empfohlen)
• ISPConfig + Apache2: Sie haben ISPConfig und bevorzugen Apache2
• Nginx Standalone: VPS/Cloud-Server, keine Panel-Software
• Apache2 Standalone: Dedicated Server, vollständig manuell

F: Wie lange dauert die Installation?

A: Zwischen 20-40 Minuten, abhängig von Ihrer Erfahrung und der Methode.

F: Kann ich SQLite statt MySQL verwenden?

A: Ja, aber nicht für Production!

• SQLite: Nur für Entwicklung/Testing
• MySQL: Empfohlen für kleine bis mittlere Installationen
• PostgreSQL: Best für große Installationen

F: Wie viele Worker sollte Gunicorn haben?

A: Faustregel: (2 × CPU-Kerne) + 1

• 1 Kern: 3 Worker
• 2 Kerne: 5 Worker
• 4 Kerne: 9 Worker
• 8 Kerne: 17 Worker

F: Ist Let's Encrypt ausreichend für SSL?

A: Ja, Let's Encrypt ist völlig ausreichend und kostenlos. Certbot verwaltet die Erneuerung automatisch.

---

Datenbank & Performance

F: Wie richte ich regelmäßige Backups ein?

A: Fügen Sie dies in Crontab ein:

# Täglich um 2 Uhr morgens
0 2 * * * cd /var/www/helpdesk && python manage.py dumpdata | gzip > /backups/helpdesk_$(date +\%Y\%m\%d).json.gz

# Media-Dateien täglich um 3 Uhr
0 3 * * * tar -czf /backups/media_$(date +\%Y\%m\%d).tar.gz /var/www/helpdesk/media/

F: Wie überwache ich die Anwendung?

A: Mehrere Optionen:

• Simple Shell-Script: Heartbeat-Check alle 5 Minuten
• Systemd: Automatisches Restart bei Fehler
• New Relic/DataDog: Professionelles Monitoring (optional)
• Logs: Regelmäßig `/var/log/nginx/error.log` prüfen

F: Wie optimiere ich die Datenbank?

A:

# Indexes überprüfen
python manage.py dbshell

# In MySQL:
ANALYZE TABLE helpdesk_tickets;
OPTIMIZE TABLE helpdesk_tickets;

---

Email & Kommunikation

F: Welchen SMTP-Server soll ich verwenden?

A: Abhängig von Ihrem Email-Anbieter:

• Office 365: smtp.office365.com:587 (TLS)
• Gmail: smtp.gmail.com:587 (TLS, App-Passwort nötig)
• Eigener Server: Ihre Domain, Port 25/465/587

F: Warum funktioniert Email nicht?

A: Überprüfen Sie:

• EMAIL_USERNAME und EMAIL_PASSWORD in .env
• Für Office 365: App-Passwort verwenden (nicht Konto-Passwort)
• SMTP_PORT = 587 mit TLS
• Firewall blockiert Port 587 nicht

F: Kann ich Email-Templates anpassen?

A: Ja, im Admin-Panel:

Admin-Panel → Einstellungen → Email-Templates → Bearbeiten

---

Sicherheit

F: Ist DEBUG=True sicher?

A: NEIN! NIEMALS in Production!

Mit DEBUG=True werden:

• Komplette Stack Traces angezeigt
• Alle Environment-Variablen sichtbar
• Geheimnisse (Passwörter) offengelegt

Nutzen Sie immer DEBUG=False in Production.

F: Wie sicher ist der SECRET_KEY?

A: Der SECRET_KEY muss:

• Zufällig sein
• Geheim bleiben (nicht in Git)
• Lang genug sein (mindestens 50 Zeichen)

Generieren Sie einen mit:

python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())'

F: Welche Firewall-Ports sollte ich öffnen?

A:

• 22/TCP: SSH (nur intern!)
• 80/TCP: HTTP (für Let's Encrypt + Redirect)
• 443/TCP: HTTPS (für Website)
• Alles andere geschlossen!

---

Updates & Wartung

F: Wie aktualisiere ich das System?

A:

cd /var/www/helpdesk
source venv/bin/activate

# Code aktualisieren
git pull

# Dependencies aktualisieren
pip install -r requirements.txt --upgrade

# Datenbank-Migrationen
python manage.py migrate

# Static Files
python manage.py collectstatic --noinput

# Service neu starten
sudo systemctl restart helpdesk

F: Wie sicher sind Abhängigkeits-Updates?

A: Immer auf einem Test-System testen vor Production!

# Verfügbare Updates prüfen
pip list --outdated

---

Logs & Debugging

F: Wo finde ich die Logs?

A:

• Gunicorn: /var/www/helpdesk/logs/gunicorn-error.log
• Nginx: /var/log/nginx/error.log
• Apache2: /var/log/apache2/error.log
• Django: /var/www/helpdesk/logs/helpdesk.log
• Systemd: sudo journalctl -u helpdesk -f

F: Wie aktiviere ich Debug-Logging?

A: In `settings.py` (nur für Entwicklung!):

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'file': {
            'level': 'DEBUG',
            'class': 'logging.FileHandler',
            'filename': '/var/www/helpdesk/logs/helpdesk.log',
        },
    },
    'root': {
        'handlers': ['file'],
        'level': 'DEBUG',
    },
}

---

ISPConfig spezifisch

F: Meine Nginx-Direktiven werden nicht angewendet

A:

1. In ISPConfig speichern Sie erneut
2. Syntax prüfen: sudo nginx -t
3. Reload: sudo systemctl reload nginx
4. Browser-Cache leeren: Ctrl+Shift+Delete

F: Wie ändere ich den Port in ISPConfig?

A:

1. In der Service-Datei: --bind 127.0.0.1:8002
2. In den Nginx Directives: server 127.0.0.1:8002;
3. Service neu starten

---

Performance & Scaling

F: Die Website ist langsam - was kann ich tun?

A:

1. Gunicorn Worker erhöhen
2. Datenbank-Indexes überprüfen
3. Caching aktivieren
4. Logs auf langsame Queries prüfen
5. Python-Packages aktualisieren

F: Wie viel RAM benötige ich?

A:

• Minimal: 2 GB
• Empfohlen: 4 GB
• Große Installation: 8+ GB

Pro Gunicorn Worker: ~50-100 MB

---

Support

F: Ich brauche Hilfe - wen kontaktiere ich?

A:

• Email: [email protected]
• Sales: [email protected]
• Website: www.aborosoft.de

Bitte mitteilen:

• Fehlermeldungen & Logs
• Systeminfo (OS, Python, MySQL-Version)
• .env Datei (ohne Passwörter!)
• Was Sie gerade versucht haben

---

© 2025 ABoro-Soft - FAQ

FAQ, Fragen, Antworten, Installation, Konfiguration, Hilfe