So installieren Sie Activepieces mit Docker auf Ihrem Server

Activepieces ist eine Automatisierungsplattform, mit der Sie Anwendungen verbinden, Webhooks empfangen und Workflows über eine visuelle Oberfläche ausführen können. Zusätzlich zur Nutzung des Cloud-Dienstes können Sie Installieren Sie Activepieces auf Ihrem eigenen Server und die Anwendung, die Datenbank und die Updates direkt steuern.

Die empfohlene Methode zum Selbsthosting ist: Docker ComposeBei dieser Methode werden die Schnittstelle und die API, die für die Ausführung der Datenflüsse zuständigen Worker, PostgreSQL und Redis separat bereitgestellt. Eine vereinfachte Installation in einem einzelnen Container ist ebenfalls möglich, jedoch nur für private Projekte und Tests geeignet.

Das Selbsthosting der Plattform verbessert die Kontrolle über die Infrastruktur, bedeutet aber nicht, dass alle Daten automatisch auf dem Server verbleiben. Wenn ein Workflow Gmail, Slack, OpenAI oder eine andere externe API nutzt, werden die erforderlichen Informationen weiterhin an den jeweiligen Anbieter gesendet. Deshalb sollten Sie auch Verbinden Sie Agenten und Automatisierungen, ohne Anmeldeinformationen preiszugeben..

Welche Activepieces-Installation sollten Sie wählen?

Activepieces bietet zwei Hauptwege mit Docker. Die Wahl hängt vom Verwendungszweck, der Anzahl der Ausführungen und der Möglichkeit zur späteren Skalierung der Infrastruktur ab.

Einrichtung	Komponenten	Empfohlene Verwendung
Einzelbehälter	Anwendung, PGLite und Speicherwarteschlange	Persönliche Tests und Projekte
Docker Compose	Anwendung, Worker, PostgreSQL und Redis	Stabiler Server und Ausrüstung
Produktionsarchitektur	Apps, Worker, PostgreSQL, Redis und S3-Speicher	Hohe Parallelität und skalierbare Bereitstellungen

Der einzelne Container verwendet PGlite als integrierte Datenbank Die Jobwarteschlange wird im Arbeitsspeicher verwaltet. Es wird nur eine Instanz pro Rechner unterstützt und eine direkte Migration in eine Enterprise-Installation ist nicht möglich. Für eine spätere Migration zur vollständigen Architektur ist eine neue Bereitstellung erforderlich.

Docker Compose eignet sich besser, wenn Sie Datenflüsse in PostgreSQL beibehalten, Redis für Warteschlangen verwenden und die Ausführung von Automatisierungen mithilfe von Workern trennen möchten.

Voraussetzungen für die Installation von Activepieces mit Docker

Für die offizielle Installation mit Docker Compose werden folgende Ressourcen benötigt:

• Docker und Docker Compose v2.
• Mindestens 2 vCPUs und 4 GB RAM.
• Un Linux-System oder ein Docker-kompatibler Server.
• WSL2 wenn Sie das Installationsprogramm unter Windows ausführen.
• Zugriff auf ein Terminal mit Berechtigungen zur Verwaltung von Docker.
• Eine Domain, falls Sie Webhooks aus dem Internet empfangen müssen.
• HTTPS für eine öffentliche Installation oder Produktionsumgebung.

Prüfen Sie, ob Docker Compose v2 verfügbar ist:

docker compose version

Der korrekte Befehl enthält ein Leerzeichen zwischen docker y composeDas antike Werkzeug docker-compose Es entspricht Compose v1 und funktioniert nicht mit der aktuellen Bereitstellung.

Wenn Sie Windows verwenden, starten Sie eine Linux-Distribution mit WSL2 und führen Sie die Installationsbefehle dort aus. Docker Desktop muss für die Integration mit dieser Distribution konfiguriert sein.

Schnelle Installation für private Projekte

Wenn Sie Activepieces nur auf einem Rechner testen möchten und keine Skalierung benötigen, können Sie mit der vereinfachten Version und einem einzelnen Container beginnen:

docker run -d --name activepieces -p 8080:80 \
  -v ~/.activepieces:/root/.activepieces \
  -e AP_DB_TYPE=PGLITE \
  -e AP_REDIS_TYPE=MEMORY \
  -e AP_FRONTEND_URL="http://localhost:8080" \
  activepieces/activepieces:latest

Dieser Befehl:

• Activepieces veröffentlichen durch den Hafen 8080.
• Speichern Sie die Konfiguration und die Datenbank. en ~/.activepieces.
• Verwenden PGlite als integrierte Datenbank.
• Verwaltet die Ausführungswarteschlange im Prozessspeicher.

Sobald der Container gestartet ist, öffnen Sie Folgendes:

http://localhost:8080

Der erste Benutzer, den Sie registrieren, wird Administrator. Es gibt keinen Standardbenutzernamen und kein Standardpasswort..

Dieser Ansatz eignet sich nicht für den Produktiveinsatz, mehrfache Replikationen oder Installationen, die Funktionen auf Unternehmensebene erfordern. Besteht Skalierbarkeit des Projekts, sollten Sie direkt mit Docker Compose beginnen.

So installieren Sie Activepieces mit einem einzigen Befehl

Die offizielle Dokumentation empfiehlt ein Skript, das die Konfiguration erstellt, die Geheimnisse generiert und die Container startet. Navigieren Sie zunächst zu dem Ordner, in dem Sie die Bereitstellungsdateien speichern möchten, und führen Sie Folgendes aus:

curl -fsSL https://get.activepieces.com | sh

Wenn Sie den Inhalt vor der Ausführung überprüfen möchten, können Sie ihn im Terminal anzeigen lassen:

curl -fsSL https://get.activepieces.com

Das Installationsprogramm erstellt einen Ordner namens activepiecesBereiten Sie die Datei vor. .env und stellt die notwendigen Dienste bereit.

Falls Port 8080 bereits belegt ist, geben Sie bitte einen anderen an:

curl -fsSL https://get.activepieces.com | sh -s -- --port 8090

Sie können auch ein anderes Verzeichnis auswählen:

curl -fsSL https://get.activepieces.com | sh -s -- --dir /ruta/activepieces

Wenn Sie fertig sind, öffnen Sie http://localhost:8080 oder ersetzt localhost anhand der IP-Adresse des Servers.

Wie man Activepieces manuell mit Docker Compose installiert

Die manuelle Installation ermöglicht es Ihnen, die Compose-Datei und die Variablen vor dem Starten von Containern zu überprüfen. Beginnen Sie mit dem Klonen des Repositorys:

git clone --depth 1 https://github.com/activepieces/activepieces.git
cd activepieces

Führen Sie anschließend das Skript aus, das die Datei vorbereitet. .env und generiert die Passwörter:

sh tools/deploy.sh

Dieser Prozess benötigt opensslFalls es nicht installiert ist, kann das Skript ohne Anzeige eines offensichtlichen Fehlers beendet werden und einige Geheimnisse fehlen. Überprüfen Sie diese, bevor Sie fortfahren:

grep -E '^(AP_ENCRYPTION_KEY|AP_JWT_SECRET|AP_POSTGRES_PASSWORD)=' .env

Alle drei Variablen müssen einen Wert enthalten:

• AP_ENCRYPTION_KEY Verschlüsseln Sie die gespeicherten Verbindungen.
• AP_JWT_SECRET signiert die Authentifizierungstoken.
• AP_POSTGRES_PASSWORD Schützt den Zugriff auf PostgreSQL.

Die Installation verwendet standardmäßig die Community Edition. Wenn Sie eine kommerzielle Lizenz besitzen und diese später aktivieren möchten, müssen Sie vor Beginn der Bereitstellung die entsprechende Edition vorbereiten und einen kompatiblen Ausführungsmodus verwenden.

Bei einer manuellen Installation wird der Service worker Es muss in der Lage sein, über den internen Namen des Containers mit der Anwendung zu kommunizieren. Prüfen Sie, ob der entsprechende Abschnitt Folgendes enthält:

worker:
  environment:
    - AP_CONTAINER_TYPE=WORKER
    - AP_FRONTEND_URL=http://app

Diese Adresse gilt nur für den Mitarbeiter. Die Variable AP_FRONTEND_URL allgemeine Akte .env Sie müssen die öffentliche URL beibehalten, die von externen Browsern und Diensten verwendet wird.

Starten Sie abschließend die Container:

docker compose -p activepieces up -d

Welche Container installiert Activepieces?

Die Bereitstellung mit Docker Compose erzeugt vier Arten von Diensten:

Container	Funktion
app	Es bietet die Schnittstelle, die API und die Plattformadministration.
worker	Es sammelt Aufträge aus der Warteschlange und führt die Arbeitsabläufe aus.
postgres	Es speichert Abläufe, Verbindungen, Benutzer und Ausführungen.
redis	Verwalten Sie die Jobwarteschlange und die ausstehenden Ausführungen.

Die PostgreSQL-Daten werden nicht direkt im geklonten Ordner gespeichert. Sie verbleiben im Docker-Volume. postgres_data. Daher, Das Kopieren nur des Ordners „Activepieces“ erstellt keine vollständige Datensicherung..

So überprüfen Sie, ob Activepieces funktioniert

Überprüfen Sie den Status der Container:

docker compose -p activepieces ps

Alle Dienste sollten scheinbar laufen. Überprüfen Sie anschließend den Health-Endpunkt:

curl http://localhost:8080/api/v1/health

Anmelden und öffnen Plattformadministrator > Infrastruktur > MitarbeiterMindestens ein Mitarbeiter muss verfügbar sein. Ist die Liste leer, kann der Mitarbeiter wahrscheinlich nicht mit der Anwendung kommunizieren.

Sie können auch Echtzeitdaten einsehen:

docker compose -p activepieces logs -f app
docker compose -p activepieces logs -f worker

So konfigurieren Sie die Domäne und Webhooks

Activepieces-Anwendungen AP_FRONTEND_URL zum Generieren von Webhook-Adressen, OAuth-Weiterleitungen und öffentlichen Links. Wenn es enthält localhostDienste wie Stripe, GitHub oder Slack können keine Daten aus dem Internet senden.

Bearbeiten Sie die Datei .env und führt die Gemeinfreiheit ein:

AP_FRONTEND_URL=https://automatizaciones.tudominio.com

Anschließend werden die Dienste neu erstellt, um die Änderung umzusetzen:

docker compose -p activepieces up -d

Um Tests von einem Computer ohne öffentliche IP-Adresse aus durchzuführen, kann man einen temporären Tunnel verwenden:

ngrok http 8080

Geben Sie die vom Tunnel bereitgestellte HTTPS-Adresse ein. AP_FRONTEND_URL und startet die Container neu. Ngrok ist nützlich für Tests, aber seine Adresse kann sich ändern und Es sollte nicht als dauerhafte Produktionskonfiguration betrachtet werden..

Cloudflare Tunnel kann auch verwendet werden, um die Instanz zu veröffentlichen, ohne Port 8080 direkt zu öffnen. Allerdings müssen Sie die Domain, HTTPS und die WebSocket-Unterstützung entsprechend konfigurieren.

Wie man Activepieces mit HTTPS schützt

Eine öffentliche Instanz muss HTTPS verwenden. Sie können die Verschlüsselung mithilfe eines Reverse-Proxys wie Nginx, eines Load Balancers oder des Proxy-Dienstes Ihres Internetanbieters beenden.

Eine grundlegende Nginx-Konfiguration sollte Anfragen an Port 8080 weiterleiten und WebSocket-Verbindungen zulassen:

location / {
    proxy_pass http://localhost:8080;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

Das Zertifikat kann über Let's Encrypt, Certbot, Cloudflare oder Ihren Infrastrukturanbieter bezogen werden. Sobald HTTPS aktiviert ist, überprüfen Sie Folgendes: AP_FRONTEND_URL beginnt mit https://.

Veröffentlichen Sie PostgreSQL oder Redis nicht direkt im Internet. Beschränken Sie außerdem den SSH-Zugriff, halten Sie Docker auf dem neuesten Stand und verwenden Sie unterschiedliche Passwörter für den Server und die verbundenen Anwendungen.

So erstellen Sie ein Backup

Vor dem Aktualisieren von Activepieces muss die Datenbank exportiert werden:

docker compose -p activepieces exec postgres \
  pg_dump -U postgres activepieces > backup.sql

Bewahren Sie außerdem eine sichere Kopie der Datei auf. .envOhne dasselbe AP_ENCRYPTION_KEYActivepieces kann gespeicherte Verbindungen nicht entschlüsseln, selbst wenn Sie PostgreSQL erfolgreich wiederherstellen.

Bei einer persönlichen Installation mit PGLite müssen Sie den folgenden Ordner sichern:

~/.activepieces

Speichern Sie Backups nicht ausschließlich auf demselben Server. Verwenden Sie einen anderen Computer, verschlüsselten Speicher oder ein versioniertes Backup-System.

So aktualisieren Sie Activepieces

Prüfen Sie zunächst, ob inkompatible Änderungen für die neue Version veröffentlicht wurden. Führen Sie nach dem Erstellen der Sicherung Folgendes aus:

curl -fsSL https://get.activepieces.com | sh -s -- --upgrade

Das Installationsprogramm behält die Datei bei .env, die Daten und vorgenommenen Änderungen in docker-compose.ymlDie verwendete Version ist festgelegt durch AP_VERSIONDadurch werden versehentliche Aktualisierungen bei jedem Neustart der Container verhindert.

Im persönlichen Container müssen Sie es anhalten, es zurückversetzen ~/.activepiecesLöschen Sie den alten Container, laden Sie das neue Image herunter und erstellen Sie es mit demselben Volume neu.

Häufige Fehler bei der Installation von Activepieces

Der Befehl docker compose existiert nicht.

Überprüfen Sie die Version:

docker compose version

Falls der Befehl fehlschlägt, installieren Sie Docker Compose v2. Ersetzen Sie den Befehl nicht automatisch durch docker-composeda die aktuelle Bereitstellung Compose v1 nicht unterstützt.

Hafen 8080 ist bereits belegt

Installation auf einem anderen Port:

curl -fsSL https://get.activepieces.com | sh -s -- --port 8090

Bei einer bestehenden Installation ändert es sich AP_HOST_PORT innerhalb .env und erstellt die Container neu. Ändern Sie AP_PORT nicht.weil es dem internen Port entspricht und die Zuordnung unterbrechen kann.

Die Seite „Mitarbeiter“ scheint leer zu sein.

Überprüfen Sie die Aufzeichnungen:

docker compose -p activepieces logs worker | grep -i socket

Wiederholte Socket.IO-Fehler deuten in der Regel darauf hin, dass der Worker versucht, eine Verbindung herzustellen. localhost oder aus Docker heraus in die öffentliche Domäne. Konfigurieren Sie für diesen Dienst Folgendes:

AP_FRONTEND_URL=http://app

Webhooks zeigen localhost an

Geben Sie die Public Domain in der Variablen ein. AP_FRONTEND_URL aus der Datei .env Starten Sie die Dienste neu. Die Adresse muss von der externen Anwendung, die den Webhook sendet, erreichbar sein.

Die Testbuttons oder Echtzeitaktualisierungen funktionieren nicht.

Der Reverse-Proxy leitet WebSocket-Verbindungen wahrscheinlich nicht korrekt weiter. Überprüfen Sie die Header. Upgrade y Connection Aktivieren Sie außerdem HTTPS, da einige Browser unverschlüsselte WebSockets blockieren.

Die Schlüssel in der .env-Datei sind leer.

Installieren openssl und führe es erneut aus:

sh tools/deploy.sh

Beginnen Sie die Installation erst, wenn Sie dies bestätigt haben. AP_ENCRYPTION_KEY, AP_JWT_SECRET y AP_POSTGRES_PASSWORD Sie enthalten Werte.

Die Anwendung startet ständig neu.

Überprüfen Sie den Startfehler:

docker compose -p activepieces logs app | grep -i "failed to start"

Eine mögliche Ursache ist die Verwendung von AP_EDITION=ee zusammen mit AP_EXECUTION_MODE=UNSANDBOXEDDie Enterprise Edition lehnt diese Kombination ab; sie verwendet einen kompatiblen Sandbox-Modus als SANDBOX_CODE_ONLY.

Die Datenflüsse verschwinden, nachdem die Container neu erstellt wurden.

Überprüfen Sie, ob die Lautstärke postgres_data Es existiert noch, und Sie haben keine vollständige Löschung durchgeführt. Das Löschen von Containern sollte das Volume nicht löschen, Befehle zum Löschen von Volumes können die Datenbank jedoch dauerhaft zerstören.

Wenn eine Automatisierung stoppt, überprüft sie zunächst die Anwendungs- und Worker-Protokolle. Dieselbe Methodik ist nützlich, um Folgendes zu ermitteln: Was tun, wenn eine Automatisierung fehlschlägt? und ein Problem vom Ablauf eines Infrastrukturausfalls zu trennen.

Wann benötigt man eine Produktionsarchitektur?

Für den Einstieg in die Einrichtung eines eigenen Servers ist Docker Compose ausreichend, aber eine Organisation mit vielen gleichzeitig laufenden Prozessen muss die Komponenten trennen und skalieren können.

Die empfohlene Produktionsarchitektur verwendet Unabhängige Worker, mehrere Anwendungsreplikate, PostgreSQL, Redis und S3-kompatibler SpeicherDie Kapazität sollte auf Basis der maximalen Anzahl gleichzeitiger Datenflüsse berechnet werden, nicht nur auf Basis der täglichen Anzahl an Ausführungen.

Sie sollten außerdem Überwachung, Protokollaufbewahrung, verifizierte Backups und Ausführungsisolation konfigurieren. Selbsthosting bietet zwar Kontrolle, verlagert aber auch die Verantwortung für Verfügbarkeit, Updates und Sicherheit auf den Administrator.

Die Installation von ActivePieces mit Docker Compose ermöglicht die Steuerung einer Automatisierungsplattform über Ihre eigene Infrastruktur. Der wichtigste Aspekt ist nicht die Einrichtung der Container, sondern die Auswahl des passenden Systems (PGLite oder PostgreSQL), der Schutz von Geheimnissen, die Konfiguration einer stabilen öffentlichen URL und die regelmäßige Sicherung der Datenbank und des Verschlüsselungsschlüssels.

Mit diesen Vorkehrungen können Sie Flows ausführen, Webhooks empfangen und Anwendungen verbinden, ohne auf die gehostete Infrastruktur von Activepieces angewiesen zu sein, und gleichzeitig das System bei steigender Arbeitslast skalieren.