KI-CRM selbst hosten: Docker, Ollama, MCP - Relaticle         

Ein KI-natives CRM 2026 selbst hosten
=====================================

Hosten Sie Relaticle selbst mit Docker, Coolify oder Dokploy. Erfahren Sie, welche Modell- und Broadcasting-Einrichtung der Chat braucht und wo bei MCP und Credits Grenzen liegen.

 Manuk Minasyan · 18. August 2026 · 12 Min. Lesezeit

 ![Ein KI-natives CRM 2026 selbst hosten](https://relaticle.com/storage/ink/01M7T426NCDW0CNFHNCQD8J8R6.png) 

Relaticle lässt sich selbst hosten. Die Standard-Compose-Datei richtet Rela, den integrierten KI-Assistenten, allerdings nicht von allein betriebsbereit ein. Dafür braucht es zusätzliche Konfiguration für Modelle und Broadcasting. Diese Anleitung behandelt die Bereitstellung mit Docker Compose, Coolify und Dokploy. Sie zeigt auch, was für lokale KI zusätzlich nötig ist, und erklärt die Grenzen, die beim Selbstbetrieb bleiben.

[](#warum-sich-auch-die-ki-funktionen-zum-selbsthosten-eignen "Permalink")Warum sich auch die KI-Funktionen zum Selbsthosten eignen
-----------------------------------------------------------------------------------------------------------------------------------

Viele CRMs bewerben einen KI-Assistenten oder eine MCP-Integration, betreiben genau diese Funktionen aber weiterhin in ihrer eigenen Cloud. Das gilt auch, wenn der Quellcode des restlichen Produkts einsehbar ist. Der KI-Stack von Relaticle ist gewöhnlicher Anwendungscode und kein gehostetes Zusatzprodukt. Der Chat-Assistent ist ein Laravel-Paket. Der MCP-Server ist eine Route, die wie jede andere in `routes/ai.php` registriert wird. Beides hängt an keiner Abo-Prüfung, solange das Billing-Feature-Flag ausgeschaltet ist, wie es im veröffentlichten Docker-Image standardmäßig der Fall ist. Sie können den Assistenten mit Ihrem eigenen API-Schlüssel an Anthropic oder OpenAI anbinden. Sie können auch ganz auf Cloud-Anbieter verzichten und ein lokales Modell über Ollama betreiben. Beide Wege nutzen dieselbe Chat-Oberfläche und greifen auf dieselbe Weise auf das CRM zu. Davon unabhängig stellt der MCP-Server seine gesamte Werkzeugpalette jedem MCP-Client zur Verfügung: Suchen und Abrufen sowie Erstellen, Lesen, Aktualisieren und Löschen für Unternehmen, Personen, Verkaufschancen, Aufgaben und Notizen. Selbst gehostet läuft er genauso wie im Cloud-Tarif von Relaticle. [Claude damit zu verbinden](https://relaticle.com/de/blog/claude-per-mcp-mit-ihrem-crm-verbinden) dauert etwa zwei Minuten. Relaticle selbst steht unter der AGPL-3.0.

[](#voraussetzungen "Permalink")Voraussetzungen
-----------------------------------------------

Alle drei Bereitstellungswege unten laden dasselbe offizielle Docker-Image und dieselbe `compose.yml`. Sie unterscheiden sich vor allem darin, wie viel Infrastruktur Sie bereits betreiben.

| Bereitstellungsoption | Was Sie brauchen |
|---|---|
| Docker Compose (eigener Server) | mindestens 2 GB RAM (4 GB empfohlen), Docker 20.10+, Docker Compose v2+ |
| Coolify | Eine laufende Coolify-Instanz, eine Domain, die darauf zeigt |
| Dokploy | Eine laufende Dokploy-Instanz, eine Domain, die darauf zeigt |
| Manuell, ohne Container | PHP 8.5+, PostgreSQL 17+, Redis 7+, Node 22.12+ und pnpm, Composer 2+, Nginx oder Apache, Supervisor |

| Bereitstellungsoption | Ungefähre Dauer |
|---|---|
| Docker Compose (eigener Server) | ~15 Minuten |
| Coolify | ~15 Minuten |
| Dokploy | ~15 Minuten |
| Manuell, ohne Container | ~45-60 Minuten |

![docker compose ps zeigt app, horizon, scheduler, postgres und redis, alle gesund](https://relaticle.com/storage/ink/01M09E1REFDVZZ0X83AX2KN5MA.png)

[](#bereitstellung-mit-docker-compose "Permalink")Bereitstellung mit Docker Compose
-----------------------------------------------------------------------------------

Mit diesem Weg beginnt auch die Anleitung von Relaticle. Er ist der schnellste, wenn Sie bereits einen Server mit Docker haben.

Laden Sie die Compose-Datei herunter:

```
curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml

```

Erzeugen Sie einen Anwendungsschlüssel:

```
echo "APP_KEY=base64:$(openssl rand -base64 32)"

```

Legen Sie neben `compose.yml` eine `.env`-Datei mit mindestens den erforderlichen Variablen an:

```
APP_KEY=base64:your-generated-key-here
DB_PASSWORD=your-secure-database-password
APP_URL=https://crm.example.com
APP_PORT=8080

```

Starten Sie die Kerndienste:

```
docker compose up -d

```

Damit starten fünf Container: die App (nginx + PHP-FPM), ein Horizon-Worker für Jobs in der Warteschlange, ein Scheduler-Container, der `schedule:work` ausführt, PostgreSQL 17 und Redis 7. Datenbankmigrationen laufen beim ersten Start automatisch, einen separaten Migrationsschritt gibt es also nicht.

Legen Sie Ihren ersten Administrator an:

```
docker compose exec app php artisan make:filament-user

```

Wählen Sie bei der Abfrage das Panel `app`. Nachdem Sie Ihren Reverse-Proxy konfiguriert haben, öffnen Sie das CRM unter `{APP_URL}/app`. Wenn Sie zusätzlich das instanzweite Panel `sysadmin` wollen (später nützlich, siehe den Abschnitt zu den Einschränkungen weiter unten), führen Sie stattdessen `docker compose exec app php artisan sysadmin:create` aus oder wählen Sie bei derselben Abfrage `sysadmin`.

Stellen Sie für TLS einen Reverse-Proxy davor. Das obige Beispiel veröffentlicht die Anwendung auf dem Host-Port 8080 und lässt die Ports 80 und 443 für Ihren Proxy frei. Leiten Sie HTTPS-Verkehr an diesen Port weiter und setzen Sie `APP_URL` auf Ihre öffentliche HTTPS-Adresse. Beschränken Sie den direkten Zugriff auf den Anwendungsport. Die App vertraut weitergeleiteten Headern aus konfigurierten privaten Netzen und Loopback-Netzen. Halten Sie Proxy und Netzwerkgrenze deshalb unter Ihrer Kontrolle.

*Getestet am 24. September 2026 mit dem offiziellen Relaticle-Image 3.5.11. Eine frische Docker-Compose-Bereitstellung bestand alle fünf Health-Checks der Dienste sowie Administratoranlage und Browser-Anmeldung.*

*Dieser Test deckte weder Coolify noch Dokploy, eine manuelle Installation, die TLS-Ausstellung oder KI-Inferenz ab. Diese Wege brauchen eigene Bereitstellungsprüfungen.*

[](#bereitstellung-mit-coolify "Permalink")Bereitstellung mit Coolify
---------------------------------------------------------------------

Wenn Sie [Coolify](https://coolify.io/) bereits für andere Projekte betreiben, ist Relaticle in etwa fünf Minuten eingerichtet, wie jede andere Docker-Compose-Ressource auch:

1. Legen Sie im Coolify-Dashboard ein neues Projekt an.
2. Fügen Sie eine Ressource hinzu, wählen Sie **Docker Compose**, wählen Sie **Empty** als Quelle und fügen Sie den Inhalt von `compose.yml` ein.
3. Setzen Sie die erforderlichen Umgebungsvariablen (`APP_KEY`, `DB_PASSWORD`, `APP_URL`) im Tab Environment Variables der Ressource.
4. Setzen Sie Ihre Domain im Tab Settings des App-Dienstes. Coolify stellt das SSL-Zertifikat automatisch aus.
5. Klicken Sie auf Deploy, öffnen Sie dann die Terminal-Funktion von Coolify für den Container `app` und führen Sie `php artisan make:filament-user` aus.

[](#bereitstellung-mit-dokploy "Permalink")Bereitstellung mit Dokploy
---------------------------------------------------------------------

[Dokploy](https://dokploy.com/) funktioniert nach demselben Muster:

1. Legen Sie ein Projekt an, fügen Sie dann einen Compose-Dienst mit der Quelle **Raw** hinzu und fügen Sie `compose.yml` ein.
2. Setzen Sie `APP_KEY`, `DB_PASSWORD` und `APP_URL` im Tab Environment des Dienstes. Setzen Sie außerdem `APP_PORT=8080`. Das Dokploy-Dashboard belegt meist selbst Port 80, und die Zuordnung des App-Containers zu 8080 vermeidet den Konflikt.
3. Klicken Sie auf Deploy und warten Sie, bis die Health-Checks aller fünf Container bestanden sind.
4. Fügen Sie Ihre Domain im Tab Domains des App-Dienstes hinzu, setzen Sie den Container-Port auf 8080 und aktivieren Sie HTTPS (Dokploy übernimmt Let's Encrypt).
5. Öffnen Sie das Terminal von Dokploy für den Container `app` und führen Sie `php artisan make:filament-user` aus.

[](#ganz-ohne-container "Permalink")Ganz ohne Container
-------------------------------------------------------

Wenn Docker keine Option ist, dokumentiert Relaticle auch eine manuelle Installation: das Repository klonen, `composer install --no-dev --optimize-autoloader`, `pnpm install --frozen-lockfile && pnpm run build`, `php artisan migrate --force`, Berechtigungen für `storage` und `bootstrap/cache` setzen, dann Horizon unter Supervisor und `schedule:run` per Cron ausführen. Es ist dieselbe Anwendung, nur ohne die Containergrenze. Das lohnt sich, wenn Sie ohnehin eine Flotte von Bare-Metal-Laravel-Apps unter einem Prozessmanager vereinheitlichen. Eine verkürzte Variante gibt es nicht. Planen Sie also eher eine Stunde ein und folgen Sie der vollständigen Anleitung.

[](#ki-voraussetzungen-ollama-broadcasting-und-mcp "Permalink")KI-Voraussetzungen: Ollama, Broadcasting und MCP
---------------------------------------------------------------------------------------------------------------

Die Compose-Datei startet die Kerndienste. MCP nutzt die Anwendungsroute. Der Chat braucht zusätzlich Modellzugangsdaten, funktionierendes Broadcasting und einen laufenden Reverb-Dienst. Die Basis-Compose-Datei konfiguriert diese Teile nicht. Verstehen Sie das Folgende als Konfigurationshinweis und nicht als vollständig getestetes Rezept für eine Chat-Bereitstellung. Prüfen Sie einen vollständigen Chat-Durchlauf auf Ihrem konfigurierten Stack, bevor Sie sich darauf verlassen.

**Lokales Modell über Ollama.** Setzen Sie diese Werte in der Umgebung Ihrer Bereitstellung. Reichen Sie sie außerdem in den `environment`-Abschnitten von `app` und `horizon` durch. Compose übergibt nicht beliebige `.env`-Einträge an Container. Erstellen Sie die Dienste nach der Änderung der Konfiguration neu. Diese Modelleinstellungen ersetzen nicht die oben beschriebene Reverb-Einrichtung:

```
OLLAMA_BASE_URL=http://host.docker.internal:11434
OLLAMA_MODEL=qwen3:14b

```

`OLLAMA_BASE_URL` steht standardmäßig auf `http://localhost:11434`. Aus einem Container heraus meint das den Container selbst und nicht Ihren Host. Unter Docker Desktop (Mac oder Windows) erreicht `host.docker.internal` den Host ohne weitere Schritte. Auf einem Linux-Server, wo die meisten selbst gehosteten Installationen laufen, sind zwei weitere Schritte nötig. Dieser Hostname wird nur aufgelöst, wenn Sie ihn in Ihrer Compose-Datei bei den Diensten app und horizon ergänzen,

```
extra_hosts:
  - "host.docker.internal:host-gateway"

```

und Ollama lauscht standardmäßig nur auf Loopback. Binden Sie es an eine private Schnittstelle, die die Container erreichen, wie in den [Ollama-FAQ](https://docs.ollama.com/faq) beschrieben. Wenn Sie es mit `OLLAMA_HOST=0.0.0.0` an alle Schnittstellen binden, beschränken Sie Port 11434 per Firewall auf das Anwendungsnetz. Machen Sie einen Ollama-Endpunkt ohne Authentifizierung niemals öffentlich zugänglich. Alternativ betreiben Sie Ollama als weiteren Compose-Dienst im selben Netz und richten `OLLAMA_BASE_URL` auf dessen Dienstnamen. Installieren Sie das Modell zuerst in Ollama. `OLLAMA_MODEL` wählt dessen Tag für die Modellauswahl in der App aus. Es lädt keine Modelldateien herunter.

Nicht jedem lokalen Modell sollten Sie Schreibzugriff anvertrauen. Der Assistent hat eigene Werkzeuge, um CRM-Einträge zu durchsuchen und Änderungen vorzuschlagen. MCP stellt ein separates Werkzeugregister bereit. Kleine Modelle behaupten häufig, eine Aktion sei gelungen, ohne das Werkzeug tatsächlich aufgerufen zu haben. Prüfen Sie ein Modell daher, bevor Sie es mit echten Daten verwenden:

```
docker compose exec app php artisan chat:models --probe=ollama

```

Das führt einen Live-Smoke-Test des Tool-Callings gegen Ihren Ollama-Endpunkt aus. Die RAM-Schätzung für den CRM-Server enthält keine lokale Inferenz. Prüfen Sie Speicher- und Hardwareanforderungen des gewählten Modells separat. Eine bestandene Probe testet das Tool-Calling und nicht die Antwortqualität bei jeder CRM-Aufgabe. Wenn Sie mehrere Modelle für mehrere Nutzer gleichzeitig bereitstellen wollen, können Sie dieselbe Modellauswahl mit einem beliebigen OpenAI-kompatiblen Server verbinden (vLLM, LM Studio, LocalAI). Dafür verwenden Sie `SELF_HOSTED_AI_URL`, `SELF_HOSTED_AI_KEY` und `SELF_HOSTED_AI_MODELS`.

![Die Modellauswahl im Chat mit lokalen Ollama-Modellen neben Claude- und GPT-Einträgen](https://relaticle.com/storage/ink/01M09FYYE6NCKYW6X4Z462GGM2.png)

**MCP-Server.** Ist `MCP_DOMAIN` nicht gesetzt, erreichen Sie den Server ohne separaten Bereitstellungsschritt unter `{APP_URL}/mcp`. Erstellen Sie in der App unter **Einstellungen → Zugriffstoken** ein persönliches Zugriffstoken. Konfigurieren Sie dann einen beliebigen MCP-Client für den Zugriff auf den Server:

```
{
  "mcpServers": {
    "relaticle": {
      "type": "streamable-http",
      "url": "https://crm.example.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

```

Das ist die gesamte Werkzeugpalette: Kontoinformationen, entitätsübergreifende Suche und Abruf sowie CRUD für Unternehmen, Personen, Verkaufschancen, Aufgaben und Notizen. Dazu kommen Schema-Ressourcen, damit der Client Ihre benutzerdefinierten Attribute sehen kann. Die Route unterscheidet sich bei einer selbst gehosteten Installation nicht von der gehosteten, abgesehen von der Domain, auf die Sie zeigen.

[](#worauf-sie-beim-selbsthosten-tatsächlich-verzichten "Permalink")Worauf Sie beim Selbsthosten tatsächlich verzichten
-----------------------------------------------------------------------------------------------------------------------

Das Selbsthosten der KI-Funktionen hat Grenzen. Kennen Sie sie, bevor Sie sich darauf verlassen.

- **Selbst gehosteter Chat verbraucht ab v3.8.1 keine Credits.** Ab v3.8.1 (4. November 2026) erfasst eine selbst gehostete Installation keinen Credit-Verbrauch mehr. Jedes konfigurierte Modell steht zur Verfügung. Der Chat behält ein Limit pro Minute, das `CHAT_RATE_LIMIT_PER_MINUTE` ändert oder abschaltet. Bis v3.8.0 wurde der selbst gehostete Chat nach Credits abgerechnet, auch mit eigenem API-Schlüssel oder lokalem Modell. Ein neuer Arbeitsbereich erhielt das Free-Kontingent von 300 Credits pro Kalendermonat. In diesen Versionen kann das instanzweite Panel `sysadmin` (`{APP_URL}/sysadmin`, mit dem zuvor angelegten Konto) das Guthaben eines Arbeitsbereichs anpassen oder seinen Tarif wechseln, ganz ohne Stripe-Konto.

    ![Die Seite für Credit-Guthaben im Panel sysadmin, bis v3.8.0, mit den Aktionen Adjust und Reset period je Arbeitsbereich](https://relaticle.com/storage/ink/01M09FZ0J61P4D2TPPCEV27EJJ.png)
- **Jede Antwort hat ein Budget von 120 Sekunden.** Wenn ein Modell nicht rechtzeitig fertig wird, endet der Durchlauf sauber. Ihre Nachricht bleibt in der Unterhaltung, ein klarer Hinweis erscheint, und nichts geht unbemerkt verloren. „Denkende“ Modelle wie `qwen3` überlegen aber vor der Antwort und stoßen häufiger an diese Grenze. Ein kleineres oder schnelleres Modell oder eine GPU hilft.
- **Die Steuerung paralleler Tool-Aufrufe unterscheidet sich je nach Anbieter.** Relaticle deaktiviert parallele Tool-Aufrufe in seinen Anthropic- und OpenAI-Integrationen. Die selbst gehosteten Integrationen erhalten diese Steuerung nicht. Ein Durchlauf kann mehrere vorgeschlagene Schritte enthalten, und Schreibvorgänge erfordern weiterhin eine Freigabe. Prüfen Sie den gesamten Vorschlag, bevor Sie ihn freigeben.
- **Die Zuverlässigkeit des Tool-Callings schwankt stark je nach Modell.** Deshalb gibt es `chat:models --probe`. Führen Sie es aus, bevor Sie einem neuen lokalen oder selbst gehosteten Modell echte Schreibzugriffe anvertrauen. So vermeiden Sie die unangenehme Erfahrung, dass ein kleineres Modell einen Löschvorgang stillschweigend überspringt, obwohl es behauptet, ihn ausgeführt zu haben.

Die Freigabe gilt nur für den integrierten Assistenten, und das galt bis v3.8.0 auch für die Abrechnung. Direkte MCP-Nutzung verbraucht nicht das Credit-Guthaben des integrierten Assistenten. Ihr MCP-Client oder Ihr Modellanbieter kann aber separat Kosten berechnen.

[](#wie-es-weitergeht "Permalink")Wie es weitergeht
---------------------------------------------------

Sichern Sie PostgreSQL, hochgeladene Dateien, die Bereitstellungskonfiguration und den ursprünglichen `APP_KEY` gemeinsam. Halten Sie die schreibenden Anwendungsprozesse an, während Sie die Datenbank- und Speicherkopien erstellen.

Verwenden Sie für eine Wiederherstellungsübung eine separate Bereitstellung mit leerer Datenbank. Stellen Sie die Datenbank wieder her, bevor Sie die Anwendung starten und ihre automatischen Migrationen ausführen.

Nutzen Sie `psql -v ON_ERROR_STOP=1`, damit SQL-Fehler den Import scheitern lassen. Stellen Sie hochgeladene Dateien samt Besitzverhältnissen wieder her und prüfen Sie dann Beziehungen, verschlüsselte Werte und die Bytes der Anhänge.

Halten Sie ausgehende Integrationen gesperrt und Worker gestoppt, bis die Wiederherstellungsprüfungen bestanden sind. Bewahren Sie während der Übung das ursprüngliche Image und die Verschlüsselungsgeheimnisse unverändert auf.

Die Referenz der Umgebungsvariablen, Hinweise zur Bereitstellung und Fehlerbehebung bei Neustartschleifen und fehlgeschlagenen Migrationen finden Sie in der Selbsthosting-Anleitung: [relaticle.com/developers/self-hosting](https://relaticle.com/de/developers/self-hosting). Die vollständige MCP-Werkzeugliste, die Schema-Ressourcen und die Einrichtung für Claude Desktop, Claude Code, Cursor und VS Code finden Sie unter [relaticle.com/developers/mcp](https://relaticle.com/de/developers/mcp).

 Mit Tag [ #self-hosting ](https://relaticle.com/de/blog/tag/self-hosting) [ #mcp ](https://relaticle.com/de/blog/tag/mcp) 

 Auf dieser Seite

 Weiterlesen

 Ähnliche Beiträge. 
--------------------

- [  17. Nov 2026  Leitfäden 

    ###  KI-Agent hat CRM-Einträge gelöscht: Lassen sie sich wiederherstellen? 

    Hat ein KI-Agent CRM-Einträge gelöscht, hängt die Wiederherstellung vom CRM ab. Wir vergleichen HubSpot, Salesforce, Attio und Relaticle und testen die Wiederherstellung in Relaticle.

     ![](https://relaticle.com/storage/ink/01M7T5H0MED6751B8CARR1SM8Y.png) 

     ](https://relaticle.com/de/blog/ki-agent-hat-crm-eintraege-geloescht-wiederherstellen)
- [  13. Nov 2026  Leitfäden 

    ###  ChatGPT-Konnektoren für Ihr CRM: sicher einrichten 

    ChatGPT-Konnektoren sind jetzt Apps innerhalb von Plugins. Verbinden Sie jeden CRM-Arbeitsbereich einmal. Prüfen Sie die Rechte Ihrer Rolle und klären Sie, wie Sie die Verbindung widerrufen können.

     ![](https://relaticle.com/storage/ink/01M7T5CR8RTJXTFZXK8XK02WK9.png) 

     ](https://relaticle.com/de/blog/chatgpt-connectors-fuer-ihr-crm-sicher-einrichten)
- [  9. Nov 2026  Leitfäden 

    ###  Claude-Code-Berechtigungen: Wo Ihr CRM-Token landet 

    Claude-Code-Berechtigungen können ein Geheimnis im Klartext speichern. Wir haben getestet, wo ein CRM-Token landet und warum OAuth ihn aus Ihren Konfigurationsdateien heraushält.

     ![](https://relaticle.com/storage/ink/01M7T1E5A4AXJRCD927SS2AS8W.png) 

     ](https://relaticle.com/de/blog/claude-code-berechtigungen-wo-ihr-crm-token-landet)
