PhialsBasement · henosch · May 27, 2026 · May 27, 2026 · May 27, 2026 · May 27, 2026
diff --git a/README.de.md b/README.de.md
@@ -0,0 +1,208 @@
+# LibreCrawl 🇩🇪
+
+Ein webbasierter SEO-Crawler für Website-Analysen und technische SEO-Audits — kostenlos, quelloffen und ohne Abonnement.
+
+🌐 **Website**: [librecrawl.com](https://librecrawl.com)  
+📖 **API-Dokumentation**: [librecrawl.com/api/docs](https://librecrawl.com/api/docs/)
+
+> LibreCrawl wird ***immer*** kostenlos und quelloffen bleiben.  
+> Wenn es deine Screaming-Frog-Lizenz für 259 $/Jahr ersetzt, freut sich der Entwickler über einen [Kaffee ☕](https://www.paypal.com/donate/?business=7H9HFA3385JS8&no_recurring=0&item_name=Continue+the+development+of+LibreCrawl&currency_code=AUD).
+
+---
+
+## Was LibreCrawl macht
+
+LibreCrawl crawlt Websites und liefert detaillierte Informationen zu Seiten, Links, SEO-Elementen und Performance. Es ist als Webanwendung auf Basis von Python Flask gebaut und unterstützt mehrere gleichzeitige Benutzer mit isolierten Sitzungen.
+
+## Features
+
+- 🚀 **Multi-Tenancy** – Mehrere Benutzer können gleichzeitig crawlen, vollständig isoliert
+- 🌍 **Deutsche & englische Oberfläche** – Sprachumschalter (DE/EN) in der Kopfzeile
+- 🎨 **Eigenes CSS** – Oberfläche mit eigenem CSS-Theme personalisieren
+- 🔄 **JavaScript-Rendering** für dynamische Inhalte (React, Vue, Angular usw.)
+- 📊 **SEO-Analyse** – Titel, Meta-Beschreibungen, Überschriften, Author, Canonical u.v.m.
+- 🔗 **Link-Analyse** – Interne und externe Links mit detaillierter Beziehungskarte
+- 📈 **PageSpeed-Insights-Integration** – Core Web Vitals analysieren
+- 💾 **Mehrere Exportformate** – CSV, JSON oder XML
+- 🔍 **Problemerkennung** – Automatische SEO-Fehler- und Warnungserkennung
+- ⚡ **Echtzeit-Fortschritt** mit Live-Statistiken
+
+---
+
+## Installation
+
+### Schnellstart (automatisch)
+
+**Windows:**
+```batch
+start-librecrawl.bat
+```
+
+**Linux/Mac:**
+```bash
+chmod +x start-librecrawl.sh
+./start-librecrawl.sh
+```
+
+Das Skript prüft automatisch, ob Docker vorhanden ist, installiert Abhängigkeiten und öffnet LibreCrawl unter `http://localhost:5000`.
+
+---
+
+### Manuelle Installation
+
+#### Option 1: Docker (empfohlen)
+
+**Voraussetzungen:** Docker und Docker Compose
+
+```bash
+# Repository klonen
+git clone https://github.com/PhialsBasement/LibreCrawl.git
+cd LibreCrawl
+
+# Umgebungsdatei kopieren
+cp .env.example .env
+
+# Starten
+docker compose up -d
+
+# Browser öffnen: http://localhost:5000
+```
+
+**Lokaler Betrieb** (Standard — kein Login erforderlich):
+```bash
+# .env
+LOCAL_MODE=true
+HOST_BINDING=127.0.0.1
+```
+
+**Produktionsbetrieb** (mit Benutzeranmeldung):
+```bash
+# .env
+LOCAL_MODE=false
+HOST_BINDING=0.0.0.0
+```
+
+Nach Änderungen den Container neu bauen:
+```bash
+docker compose up -d --build
+```
+
+---
+
+#### Option 2: Python
+
+**Voraussetzungen:** Python 3.8+
+
+```bash
+# Abhängigkeiten installieren
+pip install -r requirements.txt
+
+# Optional: JavaScript-Rendering
+playwright install chromium
+
+# Starten (lokaler Modus, kein Login)
+python main.py --local
+
+# Starten (Standard mit Authentifizierung)
+python main.py
+```
+
+Browser öffnen: `http://localhost:5000`
+
+---
+
+## Betriebsmodi
+
+| Modus | Beschreibung |
+|---|---|
+| **Lokalmodus** (`--local`) | Kein Login, alle Benutzer erhalten Admin-Rechte — ideal für Einzelnutzer |
+| **Standardmodus** | Vollständiges Authentifizierungssystem mit Benutzerrollen und Ratelimits |
+
+---
+
+## Einstellungen
+
+Über den Button **„Einstellungen"** konfigurierbar:
+
+| Bereich | Optionen |
+|---|---|
+| **Crawler** | Crawl-Tiefe (bis 5 Mio. URLs), Verzögerung, externe Links |
+| **Anfragen** | User Agent, Timeouts, Proxy, robots.txt |
+| **JavaScript** | Browser-Engine, Wartezeit, Viewport-Größe |
+| **Filter** | Dateitypen und URL-Muster ein-/ausschließen |
+| **Export** | Format und Felder auswählen |
+| **Eigenes CSS** | Oberfläche mit eigenem Stylesheet anpassen |
+| **Problem-Ausschluss** | Muster für die SEO-Problemerkennung ausschließen |
+
+Für PageSpeed-Analysen einen Google-API-Schlüssel unter **Einstellungen → Anfragen** eintragen (25.000 Anfragen/Tag statt limitiertem Kontingent).
+
+---
+
+## Exportformate
+
+- **CSV** – Für Tabellenkalkulationen (Excel, Google Sheets)
+- **JSON** – Strukturierte Daten mit allen Details
+- **XML** – Für externe Tools und Weiterverarbeitung
+
+---
+
+## Plugins
+
+Eigene Plugins als `.js`-Datei in `/web/static/plugins/` ablegen — sie erscheinen automatisch als neuer Tab in der Oberfläche.
+
+```javascript
+LibreCrawlPlugin.register({
+  id: 'mein-plugin',
+  name: 'Mein Plugin',
+  tab: { label: 'Mein Tab', icon: '🔥' },
+
+  onTabActivate(container, data) {
+    // data enthält: { urls, links, issues, stats }
+    container.innerHTML = `
+      <div class="plugin-content" style="padding: 20px; overflow-y: auto; max-height: calc(100vh - 280px);">
+        <h2>Meine Analyse</h2>
+        <p>${data.urls.length} URLs gefunden</p>
+      </div>
+    `;
+  }
+});
+```
+
+Beispiel-Plugins: `_example-plugin.js` (Vorlage) und `e-e-a-t.js` (E-E-A-T-Analyse).
+
+---
+
+## Bekannte Einschränkungen
+
+- PageSpeed API hat Ratelimits (mit API-Schlüssel deutlich besser)
+- Große Websites benötigen mehr Zeit
+- JavaScript-Rendering ist langsamer als reines HTTP-Crawling
+- Einstellungen werden im Browser-LocalStorage gespeichert (gehen verloren, wenn Browser-Daten gelöscht werden)
+
+---
+
+## Projektstruktur
+
+```
+main.py                  – Flask-Server und Haupt-Einstiegspunkt
+src/crawler.py           – Kern-Crawling-Engine
+src/core/seo_extractor.py – SEO-Datenextraktion
+src/crawl_db.py          – Datenbankoperationen
+web/templates/           – HTML-Templates
+web/static/js/           – Frontend-JavaScript
+web/static/locales/      – Übersetzungsdateien (de.json, en.json)
+web/static/plugins/      – Eigene Plugins
+```
+
+---
+
+## Lizenz
+
+MIT License — siehe [LICENSE](LICENSE).
+
+---
+
+## Danksagung
+
+Herzlichen Dank an **[PhialsBasement](https://github.com/PhialsBasement)** für die Entwicklung von LibreCrawl und dafür, dass er es der Community als freies, quelloffenes Werkzeug zur Verfügung stellt.
+Dieses Projekt wäre ohne seine Arbeit nicht möglich.
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -1,35 +1,41 @@
-services:
-  librecrawl:
-    build: .
-    container_name: librecrawl
-    ports:
+services:
+  librecrawl:
+    build: .
+    container_name: librecrawl
+    user: "${UID:-1000}:${GID:-1000}"
+    ports:
       # In local mode: only localhost (127.0.0.1:5000)
       # In production mode: all interfaces (0.0.0.0:5000) for LAN/WAN access
       - "${HOST_BINDING:-127.0.0.1}:5000:5000"
-    volumes:
-      # Persist the user database and settings
-      - ./data:/app/data
+    volumes:
+      # Persist the user database and settings
+      # Use a named volume so Docker preserves the /app/data ownership from
+      # the image. A root-owned bind mount can prevent SQLite from creating
+      # users.db when the app runs as the non-root librecrawl user.
+      - librecrawl-data:/app/data
     environment:
       - FLASK_APP=main.py
       - PYTHONUNBUFFERED=1
       # Set to "true" for local mode (no authentication), "false" for production
       - LOCAL_MODE=${LOCAL_MODE:-true}
       # Set to "true" to disable new user registrations
       - REGISTRATION_DISABLED=${REGISTRATION_DISABLED:-false}
+      # Set to "true" to disable guest login
+      - DISABLE_GUEST=${DISABLE_GUEST:-false}
       # Set to "true" for demo mode (1.5GB per-user memory limit)
       - DEMO_MODE=${DEMO_MODE:-false}
-      # DANGEROUS: Set to "true" to allow login as any username with no password
-      # (username only used to separate sessions). Do NOT use in production.
-      - DANGEROUSLY_SKIP_AUTH=${DANGEROUSLY_SKIP_AUTH:-false}
-      # Uncomment these for SMTP sending
-      # - SMTP_HOST=${SMTP_HOST}
-      # - SMTP_PORT=${SMTP_PORT}
-      # - SMTP_USER=${SMTP_USER}
-      # - SMTP_PASSWORD=${SMTP_PASSWORD}
-      # - SMTP_FROM=${SMTP_FROM}
-      # - SMTP_FROM_NAME=${SMTP_FROM_NAME}
-      # Add this for correct links in the verification emails
-      # - MAIN_APP_URL=${MAIN_APP_URL}
+      # DANGEROUS: Set to "true" to allow login as any username with no password
+      # (username only used to separate sessions). Do NOT use in production.
+      - DANGEROUSLY_SKIP_AUTH=${DANGEROUSLY_SKIP_AUTH:-false}
+      # Uncomment these for SMTP sending
+      # - SMTP_HOST=${SMTP_HOST}
+      # - SMTP_PORT=${SMTP_PORT}
+      # - SMTP_USER=${SMTP_USER}
+      # - SMTP_PASSWORD=${SMTP_PASSWORD}
+      # - SMTP_FROM=${SMTP_FROM}
+      # - SMTP_FROM_NAME=${SMTP_FROM_NAME}
+      # Add this for correct links in the verification emails
+      # - MAIN_APP_URL=${MAIN_APP_URL}
     restart: unless-stopped
     command: >
       sh -c "
@@ -48,6 +54,9 @@ services:
       fi;
       python main.py $$FLAGS"
 
-    # Increase shared memory size for Chrome to prevent crashes
-    shm_size: '2gb'
+    # Increase shared memory size for Chrome to prevent crashes
+    shm_size: '2gb'
+
+volumes:
+  librecrawl-data: