EchoRank-Dokumentation

Installation, erste Schritte, Problemlösung · Stand 2026-07-16 · Version 1.0.0

Wie installiere ich EchoRank?

EchoRank läuft auf deinem eigenen Rechner. Es gibt drei Wege – nimm den ersten, der zu dir passt:

Weg 1: Linux & macOS (empfohlen)

1. Lade die neueste Version von echorank.de herunter (ZIP-Datei "echorank-1.0.0.zip").
2. Entpacke die ZIP-Datei in einen Ordner deiner Wahl: `unzip echorank-1.0.0.zip -d ~/echorank`
3. Öffne ein Terminal und wechsle in den Ordner: `cd ~/echorank`
4. Starte das Installations-Skript: `bash install.sh` — Das Skript prüft, ob Node.js ≥ 20 installiert ist, lädt nötige Abhängigkeiten, und richtet den Autostart ein.
5. Das Tool startet automatisch nach der Installation und ist verfügbar unter http://localhost:3400 — Öffne die Seite im Browser.
6. Beim Starten wirst du zur Einrichtung begrüßt: Gib deine Lizenz-ID ein (erhältst du in der Kauf-E-Mail von Lemon Squeezy).
7. Danach: API-Keys für deine bevorzugten KI-Systeme eintragen (Claude, ChatGPT, Gemini, etc.) — optional, mit Verbindungstest pro Anbieter.
8. Das Tool läuft jetzt dauerhaft im Hintergrund und startet bei jedem Neustart automatisch.

Weg 2: Docker (auch für Windows)

1. Stelle sicher, dass Docker Desktop installiert ist: https://www.docker.com/products/docker-desktop — für Windows, macOS und Linux verfügbar.
2. Lade die neueste Version von echorank.de herunter und entpacke die ZIP-Datei.
3. Im Terminal: `cd ~/echorank` (oder wo du die Datei entpackt hast).
4. Starte das Tool mit Docker: `docker compose up -d` — Das startet EchoRank im Hintergrund.
5. Öffne http://localhost:3400 im Browser — das Tool ist sofort einsatzbereit.
6. Alle Daten (Projekte, Audits, Einstellungen) werden im Ordner `data/` gespeichert, der mit deinem Rechner synchronisiert bleibt — kein Cloud-Zugriff nötig.
7. Um das Tool später zu stoppen: `docker compose down` (von im Ordner `~/echorank`). Die Daten bleiben erhalten.
8. Um Updates einzuspielen: `docker compose pull && docker compose up -d` (holt die neueste Version und startet neu).

Weg 3: Manuell (für Profis)

1. Stelle sicher, dass Node.js ≥ 20 installiert ist: `node --version`
2. Lade die Quelle herunter und navigiere zum Ordner: `cd ~/echorank`
3. Installiere die Abhängigkeiten: `npm ci` (nicht npm install, das ist genauer).
4. Starte das Tool: `npm start` — Der Server baut das Frontend neu und läuft dann auf http://localhost:3400
5. Das ist die gleiche Methode, die der Autostart-Dienst nutzt. Für Entwicklung (mit Live-Reload) verwendest du `npm run dev` (startet Vite-UI auf :3401).

Die ersten 30 Minuten

1. 1. Lizenz aktivieren

Nach dem Start siehst du ein Willkommens-Banner. Gib die Lizenz-ID aus deiner Kauf-E-Mail ein und klicke "Validieren". Das Tool speichert die ID lokal — keine Online-Aktivierung nötig. Das Banner verschwindet danach.

2. 2. API-Keys konfigurieren

Klick oben rechts auf "Einstellungen" oder nutze das Zahnrad-Symbol. Dort kannst du API-Keys für Claude (Anthropic), ChatGPT (OpenAI), Gemini (Google), Perplexity, DeepSeek und Grok eintragen. Jeder Key hat einen "Verbindungstest"-Knopf — klick ihn, um zu prüfen, ob der Key gültig ist. Du brauchst mindestens einen Key, um Audits zu starten. Alle Keys werden lokal verschlüsselt gespeichert, verlassen nie deinen Rechner.

3. 3. Dein erstes Projekt anlegen

Gehe auf "Projekte" und klick "Neues Projekt". Gib deinen Website-Namen ein (z. B. "meine-agentur.de"). Das Tool erstellt automatisch eine geführte 5-Phasen-Roadmap mit 28 Maßnahmen. Jede Maßnahme erklärt im "?-Knopf", was sie bewirkt und wie du sie umsetzt.

4. 4. Die Anleitung lesen

Gehe auf "Anleitung" oben links. Dort findest du: Schritt-für-Schritt Erklärung der Roadmap, was "Echowert" bedeutet (Mention-Rate deiner Marke in KI-Antworten), und wie die Tools funktionieren. Plus eine "Wochen-Routine", damit du weißt, was du monatlich tun solltest.

5. 5. Dein erstes Audit starten (Baseline)

In deinem Projekt, Phase 1: Klick die Aufgabe "Baseline-Audit" an. Das Tool schlägt automatisch einen Prompt vor (z. B. Fragen, die KI-Systeme deinem Markt stellen). Klick "Audit starten" — das Tool befragt dann 6 KI-Systeme parallel, ob sie deine Marke von selbst nennen (mit Websuche). Dauer: 2-5 Minuten, kosten: ca. 2-3 € (zahlst du direkt an die KI-Anbieter). Der Echowert zeigt dir danach, wie oft deine Marke erwähnt wurde.

6. 6. Site-Check durchführen

In Phase 2: Nutze das "Site-Check"-Tool (auch per Links am Dashboard oben rechts). Gib deine Website-URL ein — das Tool prüft, ob deine Seite gut für KI-Suchmaschinen vorbereitet ist (richtiges robots.txt, JSON-LD-Schema, etc.). Es gibt dir einen Score 0-100 und eine Checkliste, was zu verbessern ist.

7. 7. Prompt-Set erstellen (optional)

Im "Audits"-Tab kannst du mehrere "Prompt-Sets" anlegen (z. B. für verschiedene Zielgruppen). Das Tool hilft dir, gute Fragen zu formulieren. Ein Set kannst du dann in mehreren Audits wiederverwenden, um Trends zu messen.

8. 8. Wöchentliche Routine starten

Lese in der "Anleitung" unter "Wochen-Routine" nach, was du jeden Montag tun solltest. Das Tool erinnert dich per Banner, wenn fällige Audits anstehen (automatisch alle 42 Tage). Im Hintergrund lädt das Tool jeden Montagmorgen auch die neuesten Nachrichten zu KI-Richtlinienänderungen — das "Aktualitäts-Panel" auf dem Dashboard zeigt dir, falls etwas wichtig geändert hat.

Wenn etwas hakt (Troubleshooting)

Port 3400 ist bereits in Benutzung ("Port already in use"-Fehler)

Auf deinem Rechner läuft schon etwas auf Port 3400 (oft: EchoRank selbst, doppelt gestartet). Linux: „systemctl --user restart geo-app“ ausführen. Wenn das nicht hilft: Rechner neu starten – das beendet verwaiste Prozesse zuverlässig. Für Profis: „lsof -i :3400“ zeigt, wer den Port belegt.

Node.js ist zu alt (Tool startet nicht)

Das Tool braucht Node.js ≥ 20. Prüfe: `node --version`. Falls älter: Installiere eine neuere Version von https://nodejs.org/ (LTS-Version reicht). Nach Installation: Terminal neu öffnen, dann `npm start` erneut versuchen.

"npm install" oder "npm ci" schlägt fehl (Build-Fehler bei better-sqlite3)

Das kommt selten vor, wenn C++-Build-Tools fehlen. Lösung: (Linux) `sudo apt install build-essential python3` oder (macOS) Xcode-Tools: `xcode-select --install`. Dann `npm ci` erneut versuchen. Falls es immer noch fehlschlägt: Nutze die Docker-Installation stattdessen, dort sind alle Abhängigkeiten schon enthalten.

Die Website lädt nicht (Blank Page oder Fehler)

Warte 30 Sekunden nach dem Start — das Frontend wird beim Start gebaut und kann kurz dauern. Falls immer noch leer: Öffne die Browser-Konsole (F12) und schau nach roten Fehlern. Häufigster Grund: Port-Konflikt (siehe Punkt 1). Oder: Browser-Cache leeren (Strg+Shift+Entf oder Cmd+Shift+Delete).

API-Key-Test schlägt fehl (401 Unauthorized oder "Invalid Key")

Der API-Key ist falsch oder abgelaufen. Prüfe: Hast du den Key richtig kopiert (keine Leerzeichen am Anfang/Ende)? Ist das Guthaben aufgebraucht (Claude/OpenAI/Gemini haben Kostenlimits)? Jeder Anbieter hat eine separate Konsole, wo du deinen Key generierst und den Status prüfst. Generiere einen neuen Key und probiere es erneut.

Audit bricht mitten im Lauf ab ("Cost limit exceeded")

Das Kostenlimit (Standard: 2 USD pro Audit) wurde überschritten. Das ist ein Sicherheitsmechanismus, damit du nicht versehentlich 100 € ausgibst. Lösung: Gehe zu Einstellungen und erhöhe das Limit auf z. B. 5 USD. Oder nutze weniger Engines gleichzeitig (nur Claude + ChatGPT statt alle 6). Die Kosten sind Echtkosten, die direkt an die KI-Anbieter gehen — das Tool nimmt keinen Aufschlag.

Docker-Installation: Daten sind weg nach Neustart ("data/"-Ordner leer)

Das passiert, wenn das Docker-Volume nicht richtig konfiguriert ist. Prüfe in der `docker-compose.yml`, dass ein `volumes`-Block für `./data:/app/data` existiert. Falls gelöscht: Datei von der Original-ZIP neu herunterladen oder manuell hinzufügen. Dann `docker compose down && docker compose up -d` neu starten. Daten sind nur weg, wenn das Volume wirklich nicht gemountet war — gib acht auf die `docker-compose.yml`.

Update einspielen: Fehlermeldung nach dem Herunterladen

Linux/Mac: Download entpacken, `cd ~/echorank && npm ci && npm start`. Docker: `docker compose pull && docker compose up -d`. Falls immer noch Fehler: Das liegt meist an Datenbank-Migrationen. Schau in die Logs: `npm start` (Linux/Mac) oder `docker compose logs geo-app` (Docker). Im Fehler-Log steht meist, welche Migration fehlgeschlagen ist. Im schlimmsten Fall: `data/geo.db` löschen (Neustart) — die Roadmap wird dann neu angelegt, aber alte Audits sind weg. Daher: Regelmäßig backups/ prüfen (`npm run backup`).

Wie spiele ich ein Update ein?

Wenn im Tool „Update verfügbar“ erscheint: neues Release-Zip aus deiner Lemon-Squeezy-Bestellung herunterladen, dann im EchoRank-Ordner:

bash update.sh /pfad/zum/echorank-neu.zip

Deine Daten (Projekte, Messwerte, Einstellungen) bleiben dabei vollständig erhalten. Docker-Nutzer bauen stattdessen das Image neu: docker compose build && docker compose up -d.

Wie deinstalliere ich EchoRank?

1. Systemd-Dienst deaktivieren (Linux/Mac): `systemctl --user disable --now geo-app.service geo-rescan.timer geo-newscheck.timer` — das stoppt alle Dienste.
2. Daten sichern (optional): Kopiere den Ordner `~/echorank/data/` als Backup, falls du die Projekte/Audits später noch brauchst.
3. Dienste-Dateien löschen: `rm ~/.config/systemd/user/geo-*.{service,timer}` — räumt den systemd-Ordner auf.
4. Haupt-Installation löschen: `rm -rf ~/echorank` (oder wo du den Ordner installiert hast).
5. Docker-Installation deinstallieren (falls Docker): `docker compose down` (hält die Container); `docker rmi echorank:latest` (löscht das Image). Die `data/`-Dateien bleiben unter `~/echorank/data/` erhalten — lösche den Ordner selbst, falls nicht mehr nötig.
6. Kein Residuum: EchoRank speichert KEINE Daten auf deinem System außer im Installationsordner und lokal in der SQLite-DB (`data/geo.db`). Nach Löschen des Ordners ist nichts übrig.
7. Falls Firefox/Chrome-Cache: Browser-Cache löschen (Strg+Shift+Entf), falls die Website noch irgendwo gecacht ist.
8. Fertig — deine lokalen Daten sind gelöscht, kein Cloud-Service betroffen.