1ZIP-Archiv entpacken

Entpacken Sie das beAV Pro ZIP-Archiv in ein temporäres Verzeichnis auf Ihrem Computer.

Windows

• Rechtsklick auf beAV-Pro-v1.0.zip
• "Alle extrahieren..." → Zielordner wählen

Linux/macOS

unzip beAV-Pro-v1.0.zip -d /tmp/beav-install

Inhalt des ZIP-Archivs:

beAV-Pro/
├── App/
│   ├── config/
│   │   └── config.php.example.php
│   └── web/
│       ├── index.php
│       ├── install.php
│       ├── includes/
│       ├── mobile/
│       ├── docs/
│       │   ├── dokumentation.html
│       │   ├── dokumentation_zeiterfassung.html
│       │   ├── mariadb_installation.html
│       │   ├── apache_php_installation.html
│       │   └── Installationsanleitung.html (diese Datei)
│       └── ...

2Verzeichnisse auf Server erstellen

Windows (XAMPP)

mkdir C:\xampp\htdocs\beav
mkdir C:\xampp\htdocs\beav\web
mkdir C:\xampp\htdocs\beav\config

Linux

sudo mkdir -p /var/www/beav/web
sudo mkdir -p /var/www/beav/config

# Rechte setzen
sudo chown -R www-data:www-data /var/www/beav
sudo chmod 755 /var/www/beav
sudo chmod 755 /var/www/beav/config

Dateien hochladen

Kopieren Sie nun die Dateien aus dem entpackten Archiv:

• App/web/* → /var/www/beav/web/ (WEBROOT)
• App/config/* → /var/www/beav/config/ (AUSSERHALB)

Schreibrechte prüfen

Das config/ Verzeichnis benötigt Schreibrechte für den Webserver:

# Linux - Test
sudo -u www-data touch /var/www/beav/config/test.txt
sudo -u www-data rm /var/www/beav/config/test.txt
# Kein Fehler = OK

# Windows - Rechte über Ordner-Eigenschaften → Sicherheit prüfen

3Datenbank vorbereiten

Erstellen Sie eine leere MySQL/MariaDB-Datenbank:

Via phpMyAdmin

1. phpMyAdmin öffnen
2. "Neu" → Datenbankname eingeben (z.B. beav_db)
3. Zeichensatz: utf8mb4_unicode_ci (WICHTIG!)
4. "Anlegen" klicken

Via MySQL-Kommandozeile

mysql -u root -p

CREATE DATABASE beav_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'beav_user'@'localhost' IDENTIFIED BY 'sicheres_passwort';

GRANT SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, DROP, INDEX
ON beav_db.* TO 'beav_user'@'localhost';

FLUSH PRIVILEGES;

EXIT;

4Webserver konfigurieren

Konfigurieren Sie Ihren Webserver so, dass der DocumentRoot auf das web/ Verzeichnis zeigt.

Apache - VirtualHost (Empfohlen)

<VirtualHost *:80>
    ServerName beav.example.com
    DocumentRoot "C:/xampp/htdocs/beav/web"
    # oder: /var/www/beav/web

    <Directory "C:/xampp/htdocs/beav/web">
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog "logs/beav-error.log"
    CustomLog "logs/beav-access.log" combined
</VirtualHost>

# HTTPS (für PWA erforderlich)
<VirtualHost *:443>
    ServerName beav.example.com
    DocumentRoot "C:/xampp/htdocs/beav/web"

    SSLEngine on
    SSLCertificateFile "/path/to/cert.pem"
    SSLCertificateKeyFile "/path/to/privkey.pem"

    <Directory "C:/xampp/htdocs/beav/web">
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

nginx

server {
    listen 80;
    listen [::]:80;
    server_name beav.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name beav.example.com;

    ssl_certificate /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    root /var/www/beav/web;
    index index.php index.html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Webserver neu starten

# Apache
sudo systemctl restart apache2

# nginx
sudo systemctl restart nginx

# Windows XAMPP - Apache Control Panel → Stop/Start

5Web-Installer starten

Öffnen Sie Ihren Browser und navigieren Sie zu:

https://ihre-domain.de/install.php

1Lizenzierung

Geben Sie die Lizenzdaten ein, die Sie beim Kauf erhalten haben:

• E-Mail-Adresse: Die beim Kauf angegebene E-Mail
• Lizenzschlüssel: Format XXXX-XXXX-XXXX-XXXX

Klicken Sie auf "Lizenz prüfen". Der Installer verbindet sich mit dem Lizenzserver und validiert Ihre Daten.

Mögliche Fehlermeldungen:

• "Lizenzschlüssel oder E-Mail nicht gefunden" → Daten prüfen
• "Diese Lizenz wurde gesperrt" → Support kontaktieren
• "Maximale Anzahl an Installationen erreicht" → Support kontaktieren
• "Lizenzserver nicht erreichbar" → Firewall/Internetverbindung prüfen

2Datenbank-Verbindung

Geben Sie die Zugangsdaten Ihrer MySQL/MariaDB-Datenbank ein:

Klicken Sie auf "Verbindung testen". Der Installer prüft:

• Kann eine Verbindung zur Datenbank hergestellt werden?
• Sind die Zugangsdaten korrekt?
• Ist utf8mb4 verfügbar?

Mögliche Fehlermeldungen:

• "Zugriff verweigert" → Benutzername/Passwort falsch
• "Datenbank existiert nicht" → Datenbank in Schritt 3 erstellen
• "Verbindung abgelehnt" → MySQL läuft nicht oder Host falsch

3Admin-Zugang anlegen

Erstellen Sie den ersten Administrator-Benutzer:

4Dateispeicher konfigurieren

Wählen Sie, wo Dokumente gespeichert werden sollen:

Option 1: Kein Speicher

• ✅ Keine zusätzliche Konfiguration
• ✅ Geeignet für reine Zeiterfassung
• ❌ Keine Dokumentenverwaltung

Option 2: Lokaler Speicher (Empfohlen)

• ✅ Einfache Einrichtung
• ✅ Schneller Zugriff
• ✅ Einfaches Backup

Erforderlich: Schreibbares Verzeichnis auf dem Server

Beispiel:

• Windows: E:/beav-storage
• Linux: /var/beav-storage

Klicken Sie auf "Speicher testen" - der Installer prüft Schreibrechte.

# Alle "intern"-Ordner finden und Rechte setzen
find /var/beav-storage -type d -name "intern" -exec chmod 750 {} \;
find /var/beav-storage -type d -name "intern" -exec chown root:beav-confidential {} \;

# Nur Gruppe "beav-confidential" kann lesen

Option 3: WebDAV (Enterprise)

• ✅ Zentrale Verwaltung
• ✅ Zugriff von mehreren Servern
• ✅ Externe Backups möglich

Erforderlich: WebDAV-Server (Nextcloud, Synology, etc.)

Konfiguration:

• WebDAV-URL (z.B. https://cloud.example.com/webdav/)
• Basispfad (optional, z.B. beav-storage)
• Authentifizierung (Basic/Digest/NTLM)
• Benutzername + Passwort

Option 4: Amazon S3 (Cloud)

• ✅ Unbegrenzte Skalierbarkeit
• ✅ Hochverfügbar und redundant
• ✅ Automatische Backups (je nach Anbieter)
• ✅ S3-kompatible Anbieter (AWS, MinIO, Wasabi, Backblaze, etc.)
• ❌ Erfordert Internetverbindung (bei Cloud-Anbietern)

Erforderlich: S3-kompatibler Storage-Service

Konfiguration:

• S3-Endpoint (z.B. s3.amazonaws.com oder localhost:9000 für MinIO)
• Bucket-Name (z.B. beav-storage)
• Region (z.B. eu-central-1 oder us-east-1)
• Access Key ID (AWS-Zugriffsschlüssel)
• Secret Access Key (AWS-Geheimschlüssel)

5Bestätigungen & Installation

Im letzten Schritt müssen Sie zwei wichtige Bestätigungen akzeptieren:

1️⃣ Betreiber-Pflichten

2️⃣ AGB & DSGVO

Installation starten

Nach Akzeptieren der Bestätigungen startet die automatische Installation:

1. config/config.php wird erstellt
2. Datenbank-Tabellen werden angelegt (via ensure_db.php)
3. Admin-Benutzer wird erstellt
4. Storage-Unterordner werden angelegt (falls Local/WebDAV)
5. Lizenz wird auf dem Server aktiviert
6. HTTPS-Erzwingung wird aktiviert (falls über HTTPS installiert)