AnythingMCP mit Docker Compose bereitstellen

Voraussetzungen

Stelle vor dem Start sicher, dass dein Server über Folgendes verfügt:

• Docker und Docker Compose installiert
• Ports 80 und 443 geöffnet (bei Verwendung von HTTPS)
• Ein Domainname, der auf deinen Server zeigt (optional, erforderlich für SSL)

Klonen und Setup ausführen

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp
bash setup.sh

Der interaktive Assistent führt du durch:

1. Bereitstellungsmodus — wählst du Docker (empfohlen)
2. Domain & Ports — gibst du deine Domain ein, um HTTPS über Caddy automatisch zu aktivieren
3. MCP-Authentifizierung — OAuth 2.0, API-Schlüssel oder beides
4. E-Mail (SMTP) — optional, für Verifizierung und Passwort-Zurücksetzung
5. Redis — optional, für Ratenbegrenzung und Caching

Alle Geheimnisse (JWT, Verschlüsselungsschlüssel, Datenbank-Passwort) werden automatisch generiert.

Was setup.sh macht

Das Skript übernimmt die gesamte Bereitstellungspipeline:

• Generiert .env mit sicheren Zufallsgeheimnissen
• Erstellt ein Caddyfile für automatisches Let's Encrypt SSL (wenn eine Domain angegeben wird)
• Fügt optional Redis über docker-compose.override.yml hinzu
• Führt docker compose up -d --build aus, um alle Dienste zu starten

Die Anwendung läuft als einzelner Container mit NestJS-Backend (Port 4000) und Next.js-Frontend (Port 3000), zusammen mit PostgreSQL 17.

HTTPS mit Caddy

Wenn du während des Setups eine echte Domain eingeben, wird Caddy automatisch konfiguriert:

• App-Ports binden nur an 127.0.0.1 (nicht öffentlich erreichbar)
• Caddy verarbeitet den gesamten Datenverkehr auf den Ports 80 und 443
• SSL-Zertifikate werden von Let's Encrypt bereitgestellt und erneuert

Keine manuelle Zertifikatsverwaltung erforderlich.

Bereitstellung überprüfen

Prüf, ob alle Container laufen:

docker compose ps

Überprüf den Backend-Zustand:

curl http://localhost:4000/health

Öffne das Dashboard:

• Mit Caddy: https://yourdomain.com
• Ohne Caddy: http://your-server-ip:3000

Der erste Benutzer, der sich registriert, wird zum Administrator.

AnythingMCP aktualisieren

git pull
docker compose up -d --build

Datenbankmigrationen werden beim Start automatisch ausgeführt.

Fehlerbehebung

Port-Konflikte

sudo lsof -i :80
sudo lsof -i :443

Stoppe konfliktverursachende Dienste oder deaktiviere Caddy, um die App direkt auf den Ports 3000/4000 zu erreichen.

Datenbankprobleme

Wenn du Anmeldedaten in .env geändert haben, setze das Datenbank-Volume zurück:

docker compose down -v
docker compose up -d

Logs prüfen

docker compose logs -f        # alle Dienste
docker compose logs -f app    # nur App
docker compose logs -f caddy  # nur Caddy

Caddy-Zertifikatsprobleme

Stelle sicher, dass der A-Eintrag deiner Domain auf den Server zeigt und die Ports 80/443 für die ACME-Challenge erreichbar sind.