EduLog Installationsanleitung

In unter 30 Minuten zu Ihrer eigenen EduLog-Installation

Schritt-für-Schritt Anleitung für eine kinderleichte Installation

Schnellstart

Mit Docker und Docker Compose ist EduLog in wenigen Schritten einsatzbereit. Diese Anleitung führt Sie durch den gesamten Installationsprozess – von den Voraussetzungen bis zur fertigen Installation.

1️⃣
Voraussetzungen prüfen

~5 Minuten

2️⃣
Installation

~10 Minuten

3️⃣
Konfiguration

~10 Minuten

4️⃣
Fertig!

~5 Minuten

Systemvoraussetzungen

Was Sie für die Installation benötigen

💻 Hardware

Minimal
  • 2 CPU-Kerne
  • 4 GB RAM
  • 20 GB Speicherplatz (SSD empfohlen)
Empfohlen
  • 4 CPU-Kerne
  • 8 GB RAM
  • 50 GB Speicherplatz (SSD)

🖥️ Software

Betriebssystem (eines davon)
  • Ubuntu 20.04 LTS oder neuer
  • Debian 11 oder neuer
  • CentOS/RHEL 8 oder neuer
  • Windows Server 2019 oder neuer (mit WSL2)
Erforderliche Software
  • Docker 20.10 oder neuer
  • Docker Compose 2.0 oder neuer

Schritt 1: Vorbereitung

Docker und Docker Compose installieren

Docker Installation (Ubuntu/Debian)

# System aktualisieren
sudo apt update
sudo apt upgrade -y

# Docker installieren
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

# Benutzer zur Docker-Gruppe hinzufügen
sudo usermod -aG docker $USER

# Docker aktivieren
sudo systemctl enable docker
sudo systemctl start docker

# Installation prüfen
docker --version
docker compose version
Hinweis

Nach dem Hinzufügen zur Docker-Gruppe müssen Sie sich ab- und wieder anmelden, damit die Änderungen wirksam werden.

Schritt 2: EduLog herunterladen

Installation vorbereiten

Installationspaket extrahieren

Nach dem Kauf erhalten Sie ein Lizenzpaket mit allen erforderlichen Dateien:

# Verzeichnis erstellen
sudo mkdir -p /opt/edulog
cd /opt/edulog

# Lizenzpaket extrahieren (wird Ihnen zur Verfügung gestellt)
unzip edulog-vX.X.X.zip

# Verzeichnisstruktur prüfen
ls -la
Enthaltene Dateien:
  • docker-compose.yml – Docker-Konfiguration
  • .env.example – Beispiel-Konfiguration
  • license/ – Lizenzdateien
  • docs/ – Detaillierte Dokumentation
  • README.md – Schnellstart-Anleitung

Schritt 3: Konfiguration

EduLog an Ihre Umgebung anpassen

Umgebungsvariablen einrichten

# Beispiel-Konfiguration kopieren
cp .env.example .env

# Konfiguration bearbeiten
nano .env
Wichtige Konfigurationsparameter:
# Datenbank
DB_HOST=postgres
DB_PORT=5432
DB_NAME=edulog
DB_USER=edulog
DB_PASSWORD=IhrSicheresPasswort

# Anwendung
APP_URL=https://edulog.ihr-unternehmen.de
APP_PORT=3000
SECRET_KEY=GenerierterSchluessel

# E-Mail (optional)
SMTP_HOST=mail.ihr-unternehmen.de
SMTP_PORT=587
SMTP_USER=edulog@ihr-unternehmen.de
SMTP_PASSWORD=IhrMailPasswort

# LDAP (optional)
LDAP_URL=ldap://ldap.ihr-unternehmen.de
LDAP_BIND_DN=cn=edulog,ou=services,dc=unternehmen,dc=de
LDAP_BIND_PASSWORD=IhrLDAPPasswort
Sicherheitshinweis

Verwenden Sie starke, zufällige Passwörter! Generieren Sie den SECRET_KEY mit: openssl rand -hex 32

Schritt 4: Installation starten

EduLog mit Docker Compose starten

Container starten

# Container im Hintergrund starten
docker compose up -d

# Status prüfen
docker compose ps

# Logs anzeigen
docker compose logs -f

# Warten bis alle Services bereit sind (ca. 1-2 Minuten)
Erwartete Ausgabe:
NAME                COMMAND             STATUS          PORTS
edulog-backend      "node server.js"    Up 2 minutes    0.0.0.0:3000->3000/tcp
edulog-frontend     "nginx -g ..."      Up 2 minutes    0.0.0.0:80->80/tcp
edulog-postgres     "postgres"          Up 2 minutes    5432/tcp

Schritt 5: Erster Login

EduLog aufrufen und einrichten

Setup-Assistent

  1. Browser öffnen: Rufen Sie http://localhost oder Ihre konfigurierte URL auf
  2. Setup-Assistent starten: Beim ersten Aufruf erscheint der Installations-Assistent
  3. Administrator-Konto erstellen:
    • Benutzername eingeben
    • E-Mail-Adresse angeben
    • Sicheres Passwort wählen
  4. Ersten Mandanten anlegen:
    • Unternehmensname
    • Adresse
    • Kontaktdaten
  5. Lizenz aktivieren: Lizenzschlüssel aus dem Lizenzpaket eingeben
Geschafft!

EduLog ist jetzt einsatzbereit. Sie können nun Benutzer anlegen und mit der Erfassung von Ausbildungsnachweisen beginnen.

Optional: LDAP/Active Directory Integration

Single Sign-On einrichten (Professional & Enterprise)

LDAP konfigurieren

Die LDAP-Integration ermöglicht die Anmeldung mit bestehenden Unternehmens-Konten:

  1. LDAP-Parameter in .env setzen: 
    LDAP_ENABLED=true
LDAP_URL=ldap://dc.ihr-unternehmen.de:389
LDAP_BIND_DN=cn=edulog-service,ou=Services,dc=unternehmen,dc=de
LDAP_BIND_PASSWORD=ServicePasswort
LDAP_SEARCH_BASE=ou=Users,dc=unternehmen,dc=de
LDAP_SEARCH_FILTER=(sAMAccountName={{username}})
  2. Container neu starten: 
    docker compose restart
  3. LDAP-Synchronisation testen: Im Admin-Panel unter "LDAP-Einstellungen"
  4. Benutzer-Mapping konfigurieren: Zuordnung von LDAP-Gruppen zu EduLog-Rollen
Tipp

Eine detaillierte Anleitung zur LDAP-Konfiguration finden Sie in der mitgelieferten Dokumentation unter docs/ldap-setup.md

Wartung & Updates

EduLog aktuell halten

🔄 Updates installieren

# Backup erstellen
docker compose exec postgres \
  pg_dump -U edulog edulog \
  > backup-$(date +%Y%m%d).sql

# Neue Version herunterladen
# (wird Ihnen zur Verfügung gestellt)

# Container stoppen
docker compose down

# Neue Dateien extrahieren
# und .env-Datei prüfen

# Container mit neuer Version starten
docker compose up -d

# Logs prüfen
docker compose logs -f

💾 Backup & Restore

Backup erstellen
# Datenbank-Backup
docker compose exec postgres \
  pg_dump -U edulog edulog \
  > backup.sql

# Dateien sichern
tar -czf edulog-backup.tar.gz \
  /opt/edulog/uploads \
  /opt/edulog/.env \
  backup.sql
Restore
# Datenbank wiederherstellen
docker compose exec -T postgres \
  psql -U edulog edulog \
  < backup.sql
Wichtig

Erstellen Sie regelmäßig Backups! Wir empfehlen tägliche automatische Backups der Datenbank und wöchentliche Backups der hochgeladenen Dateien.

Troubleshooting

Häufige Probleme und Lösungen

Lösung: 
# Logs prüfen
docker compose logs

# Container neu erstellen
docker compose down
docker compose up -d --force-recreate

# Ports prüfen (dürfen nicht belegt sein)
sudo netstat -tulpn | grep :3000
sudo netstat -tulpn | grep :80

Lösung:
  • Prüfen Sie die DB_HOST, DB_USER und DB_PASSWORD in der .env-Datei
  • Stellen Sie sicher, dass der Postgres-Container läuft: docker compose ps
  • Warten Sie 30-60 Sekunden nach dem Start – die Datenbank benötigt Zeit zum Hochfahren

Lösung: 
# LDAP-Verbindung testen
ldapsearch -x -H ldap://ihr-ldap-server:389 \
  -D "cn=edulog-service,ou=Services,dc=unternehmen,dc=de" \
  -w "ServicePasswort" \
  -b "ou=Users,dc=unternehmen,dc=de" \
  "(sAMAccountName=testbenutzer)"

Prüfen Sie auch die Firewall-Regeln und stellen Sie sicher, dass Port 389 (LDAP) oder 636 (LDAPS) erreichbar ist.

Lösung:
  • Stellen Sie sicher, dass ausreichend RAM verfügbar ist (mind. 4 GB)
  • Prüfen Sie die Logs: docker compose logs backend
  • Bei älteren Systemen: Chromium-Sandbox deaktivieren in der Konfiguration

Benötigen Sie Hilfe?

Unser Support-Team steht Ihnen gerne zur Verfügung.

Support kontaktieren Zurück zur Preisübersicht