ABoro-Soft Helpdesk - Installationsanleitung

Diese Anleitung führt Sie Schritt-für-Schritt durch die Installation des Helpdesk-Systems.

1. Systemanforderungen überprüfen

Bevor Sie beginnen, stellen Sie bitte sicher, dass Sie folgende Anforderungen erfüllen:

Hardware:

• Speicher: Mindestens 2 GB RAM (4+ GB empfohlen)
• Festplatte: Mindestens 5 GB freier Speicher
• CPU: Mindestens 1 Kern (2+ empfohlen)

Software:

• Betriebssystem: Ubuntu 20.04 LTS oder Debian 11+
• Python: Version 3.8+ (3.10+ empfohlen)
• Datenbank: MySQL 5.7+, PostgreSQL 10+ oder SQLite
• Web-Server: Nginx oder Apache2

Netzwerk:

• Domain registriert und auf Ihren Server zeigend
• Ports 80 (HTTP) und 443 (HTTPS) erreichbar
• SSH-Zugang zum Server

2. Wählen Sie Ihre Installationsmethode

Es gibt 4 gängige Installationsmethoden. Wählen Sie eine basierend auf Ihrem Hosting:

Empfehlung für Anfänger: ISPConfig + Nginx

3. Schritt-für-Schritt Installation (ISPConfig + Nginx)

Schritt 1: Domain in ISPConfig erstellen

1. Öffnen Sie das ISPConfig Panel
2. Gehen Sie zu Websites → Websites
3. Klicken Sie auf Add new website
4. Füllen Sie aus:
   • Domain: beispiel.de
   • Auto-Subdomain: www
   • SSL: Let's Encrypt aktivieren
5. Klicken Sie Save

Schritt 2: SSH verbinden und Virtual Environment erstellen

# SSH verbinden
ssh [email protected]

# Zum Web-Verzeichnis navigieren (Client-ID und Web-ID anpassen!)
cd /var/www/clients/client/web

# Helpdesk-Ordner erstellen
mkdir -p helpdesk
cd helpdesk

# Virtual Environment erstellen
python3 -m venv venv

# Virtual Environment aktivieren
source venv/bin/activate

# pip aktualisieren
pip install --upgrade pip setuptools wheel

Schritt 3: Abhängigkeiten installieren

# Projekt-Dateien hochladen (per SFTP/SCP)
# oder per Git clonen

# Abhängigkeiten installieren
pip install -r requirements.txt

Schritt 4: Django konfigurieren

Erstellen Sie eine .env Datei mit:

DEBUG=False
SECRET_KEY=generieren_sie_einen_zufaelligen_key
ALLOWED_HOSTS=beispiel.de,www.beispiel.de
SITE_URL=https://beispiel.de

# Datenbank
DATABASE_URL=mysql+pymysql://helpdesk_user:passwort@localhost:3306/helpdesk_db

# Email
[email protected]
EMAIL_PASSWORD=app_passwort
SMTP_HOST=smtp.office365.com
SMTP_PORT=587

# Sprache
LANGUAGE_CODE=de-de

Schritt 5: Datenbank vorbereiten

# Als root in MySQL
sudo mysql -u root -p

# In MySQL Shell:
CREATE DATABASE helpdesk_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'helpdesk_user'@'localhost' IDENTIFIED BY 'passwort';
GRANT ALL PRIVILEGES ON helpdesk_db.* TO 'helpdesk_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Schritt 6: Django Setup durchführen

# Migrationen durchführen
python manage.py migrate

# Static Files sammeln
python manage.py collectstatic --noinput --clear

# Admin-Benutzer erstellen
python manage.py createsuperuser

# Logs-Verzeichnis erstellen
mkdir -p logs

# Berechtigungen setzen
chmod -R 775 media logs

Schritt 7: Gunicorn Service erstellen

Erstellen Sie die Datei /etc/systemd/system/helpdesk-web.service:

[Unit]
Description=Helpdesk Application
After=network.target mysql.service

[Service]
Type=notify
User=web
Group=client
WorkingDirectory=/var/www/clients/client/web/helpdesk
Environment="PATH=/var/www/clients/client/web/helpdesk/venv/bin"
EnvironmentFile=/var/www/clients/client/web/helpdesk/.env

ExecStart=/var/www/clients/client/web/helpdesk/venv/bin/gunicorn   --workers 4   --worker-class sync   --bind 127.0.0.1:8001   --timeout 30   --access-logfile /var/www/clients/client/web/helpdesk/logs/gunicorn-access.log   --error-logfile /var/www/clients/client/web/helpdesk/logs/gunicorn-error.log   helpdesk.wsgi:application

ExecReload=/bin/kill -s HUP $MAINPID
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Starten Sie den Service:

sudo systemctl daemon-reload
sudo systemctl enable helpdesk-web
sudo systemctl start helpdesk-web
sudo systemctl status helpdesk-web

Schritt 8: Nginx in ISPConfig konfigurieren

1. Öffnen Sie ISPConfig
2. Gehen Sie zu Websites → Ihre Website
3. Tab Options → Nginx Directives
4. Fügen Sie folgendes ein:

   upstream helpdesk_backend {
       server 127.0.0.1:8001;
   }
   
   location /static/ {
       alias /var/www/clients/client/web/helpdesk/staticfiles/;
       expires 30d;
       add_header Cache-Control "public, immutable";
   }
   
   location /media/ {
       alias /var/www/clients/client/web/helpdesk/media/;
       expires 7d;
   }
   
   location / {
       proxy_pass http://helpdesk_backend;
       proxy_set_header Host $host;
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_set_header X-Forwarded-Proto $scheme;
   
       proxy_connect_timeout 60s;
       proxy_send_timeout 60s;
       proxy_read_timeout 60s;
   }

5. Klicken Sie Save

4. Installation testen

Prüfen Sie, dass alles funktioniert:

# Service läuft?
sudo systemctl status helpdesk-web

# Port erreichbar?
curl http://127.0.0.1:8001

# Logs prüfen
tail -f /var/www/clients/client/web/helpdesk/logs/gunicorn-error.log

Öffnen Sie nun in Ihrem Browser:

https://beispiel.de

Die Website sollte laden. Gehen Sie zum Admin-Panel:

https://beispiel.de/admin/

Username: admin
Password: changeme123!

WICHTIG: Passwort sofort ändern!

5. Nach der Installation

Admin-Passwort ändern

1. Öffnen Sie https://beispiel.de/admin/
2. Gehen Sie zu Benutzer → Admin
3. Klicken Sie Passwort ändern
4. Geben Sie ein neues, starkes Passwort ein

Email konfigurieren

1. Gehen Sie im Admin-Panel zu Einstellungen → Email
2. Überprüfen Sie die SMTP-Einstellungen
3. Senden Sie eine Test-Email

Firewall anpassen

# Nur notwendige Ports öffnen
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

6. Häufige Probleme und Lösungen

502 Bad Gateway

• Gunicorn läuft? sudo systemctl status helpdesk-web
• Logs prüfen: tail -f /var/www/.../logs/gunicorn-error.log
• Service neu starten: sudo systemctl restart helpdesk-web

Static Files nicht geladen

# Static Files neu sammeln
python manage.py collectstatic --clear --noinput

# Service neu starten
sudo systemctl restart helpdesk-web

Datenbank-Fehler

• Datenbank läuft? sudo systemctl status mysql
• Verbindung prüfen: mysql -u helpdesk_user -p helpdesk_db
• DATABASE_URL in .env überprüfen

Email funktioniert nicht

• SMTP-Credentials in .env prüfen
• Für Office 365: App-Passwort verwenden (nicht Konto-Passwort)
• Port 587 mit TLS verwenden

7. Sicherheits-Checklist

Vor dem Go-Live überprüfen Sie bitte:

• [ ] DEBUG=False in .env
• [ ] SECRET_KEY ist zufällig
• [ ] ALLOWED_HOSTS korrekt
• [ ] SSL-Zertifikat aktiv (HTTPS)
• [ ] HTTP auf HTTPS redirect aktiviert
• [ ] Admin-Passwort geändert
• [ ] Firewall konfiguriert
• [ ] Regelmäßige Backups eingerichtet

8. Weitere Installationsmethoden

Diese Anleitung behandelt ISPConfig + Nginx. Für andere Methoden siehe:

• ISPConfig + Apache2: Ähnliche Schritte, aber mit Apache-Konfiguration statt Nginx
• Nginx Standalone: Ohne ISPConfig Panel, manuelle Nginx-Konfiguration
• Apache2 Standalone: Vollständig manuell konfiguriert

Für detaillierte Informationen lesen Sie die vollständige Dokumentation (INSTALLATION_GUIDE.md).

9. Backup einrichten

Sichern Sie regelmäßig Ihre Daten:

# Tägliches Datenbank-Backup (in Crontab)
0 2 * * * cd /var/www/helpdesk && python manage.py dumpdata | gzip > /backups/helpdesk_$(date +\%Y\%m\%d).json.gz

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

© 2025 ABoro-Soft - Installationsanleitung