Quick Start - Schnelle Installation

Die schnellste Anleitung zur Installation des Helpdesk-Systems in 30 Minuten.

3-Minuten Entscheidungshilfe

Haben Sie ISPConfig?

JA → ISPConfig + Nginx (20-30 min) - EMPFOHLEN
NEIN → Nginx Standalone (25-35 min)

Schnellstart für ISPConfig + Nginx

1. Domain in ISPConfig anlegen (5 min)

ISPConfig → Websites → Add new website
Domain: beispiel.de
Auto-Subdomain: www
SSL: Let's Encrypt aktivieren
→ Save

2. SSH verbinden und venv erstellen (5 min)

ssh [email protected]
cd /var/www/clients/client/web
mkdir -p helpdesk && cd helpdesk

python3 -m venv venv
source venv/bin/activate
pip install --upgrade pip

3. Abhängigkeiten installieren (5 min)

pip install -r requirements.txt

4. .env Datei erstellen (3 min)

cat > .env << 'EOF'
DEBUG=False
SECRET_KEY=$(python -c 'from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())')
ALLOWED_HOSTS=beispiel.de,www.beispiel.de
SITE_URL=https://beispiel.de
DATABASE_URL=mysql+pymysql://helpdesk_user:passwort@localhost:3306/helpdesk_db
[email protected]
EMAIL_PASSWORD=app_passwort
SMTP_HOST=smtp.office365.com
SMTP_PORT=587
LANGUAGE_CODE=de-de
EOF

5. Datenbank erstellen (3 min)

sudo mysql -u root -p << 'EOF'
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;
EOF

6. Django Setup (2 min)

python manage.py migrate
python manage.py collectstatic --noinput --clear
python manage.py createsuperuser
mkdir -p logs
chmod -R 775 media logs

7. Gunicorn Service (3 min)

Erstellen Sie /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 --bind 127.0.0.1:8001   --timeout 30 helpdesk.wsgi:application

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

[Install]
WantedBy=multi-user.target

Starten:

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

8. Nginx konfigurieren (2 min)

ISPConfig → Websites → Ihre Website → Options → Nginx Directives

upstream helpdesk_backend {
    server 127.0.0.1:8001;
}

location /static/ {
    alias /var/www/clients/client/web/helpdesk/staticfiles/;
    expires 30d;
}

location /media/ {
    alias /var/www/clients/client/web/helpdesk/media/;
}

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;
}

Klicken Sie Save

9. Testen (2 min)

https://beispiel.de

Falls 502-Fehler:

sudo systemctl status helpdesk-web
tail -f /var/www/clients/client/web/helpdesk/logs/gunicorn-error.log

10. Admin-Panel

https://beispiel.de/admin/
Username: admin
Password: changeme123!

WICHTIG: Passwort sofort ändern!

Nach Installation

1. Passwort ändern

Admin-Panel → Benutzer → Admin → Passwort ändern

2. Email testen

Admin-Panel → Einstellungen → Email → Test senden

3. Firewall

sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Fehlerbehebung

502 Bad Gateway

sudo systemctl restart helpdesk-web
tail -f /var/www/clients/client/web/helpdesk/logs/gunicorn-error.log

Static Files nicht geladen

python manage.py collectstatic --clear --noinput
sudo systemctl restart helpdesk-web

Datenbank-Fehler

sudo systemctl restart mysql
# Überprüfen Sie DATABASE_URL in .env

Email funktioniert nicht

Überprüfen Sie in .env:

• EMAIL_USERNAME (SMTP-User)
• EMAIL_PASSWORD (App-Passwort für Office 365!)
• SMTP_HOST = smtp.office365.com
• SMTP_PORT = 587

Sicherheits-Checklist

• [ ] DEBUG=False in .env
• [ ] Admin-Passwort geändert
• [ ] SSL aktiv (HTTPS)
• [ ] Firewall konfiguriert
• [ ] Backups eingerichtet

Wichtige Befehle

# Service Status
sudo systemctl status helpdesk-web
sudo systemctl restart helpdesk-web

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

# Django Shell
source venv/bin/activate
python manage.py shell

Weitere Informationen

• Detaillierte Installation: Siehe Installations-Anleitung
• Fehlerbehebung: Siehe Troubleshooting-Guide
• API-Dokumentation: Siehe API-Dokumentation

Geschätzter Zeitaufwand: 30 Minuten

© 2025 ABoro-Soft - Quick Start Guide