Wie man Paperclip 2026 auf einem Contabo VPS selbst hostet | Contabo Blog

Lerne, wie du Paperclip KI – die Open-Source-Plattform zur KI-Orchestrierung – 2026 auf einem Contabo VPS mit Ubuntu und Postgres selbst hostest. Am Ende hast du einen funktionierenden Paperclip-VPS, der über HTTPS abgesichert ist. Dann bist du bereit, KI-Agenten als Teil deiner eigenen Orchestrierungsplattform laufen zu lassen.

Paperclip ist eine Open-Source-Software zur KI-Orchestrierung, mit der du ein ganzes „KI-Paperclip-Unternehmen“ aus KI-Agenten mit festen Rollen, Zielen und Budgets aufbauen kannst. Statt nur eines einzelnen Chatbots definierst du ein Organigramm (CEO, Entwickler, Marketing) und lässt Paperclip KI deren Arbeit an gemeinsamen Projekten koordinieren.

Die Agenten verbinden sich über Adapter, zum Beispiel Claude Code oder andere CLI-Umgebungen. So fungiert Paperclip als KI-Orchestrator über deinen bevorzugten Modellen und Werkzeugen. Der Code liegt auf dem Paperclip-GitHub, was bedeutet, dass du ihn auf deiner eigenen Infrastruktur selbst hosten, checken und erweitern kannst.

Mit Paperclip im Self-Hosting auf einem VPS hast du die volle Kontrolle über deine Daten, die Kosten und deine Laufzeitumgebung. Du entscheidest, wo die Orchestrierungstools laufen, welche LLM-Anbieter du nutzt und wie streng deine Regeln und Budgets für die Agenten sein sollen.

Contabo passt super als VPS für KI-Agenten, weil du planbare Preise, massig RAM und Speicher sowie Rechenzentren in der EU für DSGVO-konformes Hosting bekommst. Wenn du einen europäischen VPS für dein Self-Hosting suchst, ist es total simpel, Paperclip in einem EU-Rechenzentrum zu betreiben und gleichzeitig externe APIs wie Claude oder Hermes anzubinden.

Paperclip ist eine Node.js-App mit Postgres, also brauchst du genug CPU und RAM für die Web-App, die Datenbank und Docker. Schauen wir uns an, was ein Paperclip-KI-VPS an Anforderungen und Setup braucht.

Für eine Entwicklung oder ein kleines internes Setup auf Ubuntu kannst du es schon auf minimaler Hardware laufen lassen:

Das reicht, um Paperclip KI mit ein paar Agenten und einer lokalen Postgres-Instanz auszuprobieren. Bei Contabo bietet schon ein Einsteiger-Plan für VPS-Hosting genug Ressourcen für deine ersten KI-Paperclip-Pläne.

Für die meisten Teams ist jeder Contabo Cloud VPS ein entspannter Startpunkt für Paperclip. Du bekommst genug CPU, RAM und schnellen NVMe-Speicher, um Paperclip KI zu testen, eine Sandbox zu bauen und sogar kleine Team-Workloads zu stemmen, ohne das Budget zu sprengen.

Sobald Paperclip Teil eines größeren Setups wird, das rund um die Uhr läuft, ist der Wechsel auf einen Contabo Cloud VDS S langfristig die sicherere Wahl. VDS-Pläne bieten dedizierte Ressourcen und eine stabilere Performance als Shared-VPS-Instanzen. Das wird wichtig, sobald deine KI-Plattform kritische Jobs rund um die Uhr erledigt.

Die folgenden Schritte setzen einen frischen Ubuntu 22.04/24.04 VPS und ein grundlegendes Verständnis von SSH und der Shell voraus.

Zuerst brauchst du einen VPS – überspringe diesen Schritt einfach, wenn du schon einen startklar hast. Bestelle einen Contabo VPS in deiner bevorzugten Region. Falls die DSGVO für deinen Case wichtig ist, fährst du mit einem europäischen VPS für dein Self-Hosting am besten. Wähle einen Plan, der zu den Anforderungen passt, nimm Ubuntu als OS und verbinde dich dann von deinem lokalen Rechner aus:

ssh root@SERVER_IP

Ab hier ist dieser VPS dein Paperclip-Server und hostet sowohl die Web-App als auch die Datenbank (außer du lagerst Postgres woanders aus).

Du hast zwei Wege, um Paperclip KI auf deinem Contabo VPS zum Laufen zu bringen: Den schnellen npx-Quickstart für Tests oder Docker für den langfristigen Einsatz.

Schnellster erster Start – npx paperclipai onboard
Wenn du die Paperclip-App direkt in Aktion sehen willst, update zuerst deine Paketliste und installiere Node.js auf deinem Ubuntu VPS:

sudo apt update
sudo apt install nodejs

Bestätige mit Y und installiere dann den Node.js Paketmanager:

sudo apt install npm

Bestätige mit Y und führe dann das hier aus:

npx paperclipai onboard --yes

Mehr Details findest du auf der offiziellen Paperclip GitHub-Seite.

Produktions-Weg – Paperclip mit Docker auf Ubuntu
Für eine stabile, saubere Paperclip-Bereitstellung auf deinem Contabo VPS solltest du Docker und Docker Compose nutzen. Nachdem du Docker installiert hast, kannst du die Compose-Datei vom Paperclip-GitHub nutzen, deine Umgebungsdatei konfigurieren und dann den Stack mit docker compose up -d starten, was dir eine containerisierte, selbst gehostete Paperclip-Orchestrierungsplattform liefert, die für den Dauerbetrieb geeignet ist.

Standardmäßig nutzt Paperclip eine eingebettete PostgreSQL-Instanz, wenn keine DATABASE_URL gesetzt ist. Du kannst also direkt loslegen, ohne dich um Datenbanken zu kümmern. Dieser Zero-Config-Modus ist perfekt für die lokale Entwicklung und für schnelle Tests, aber er ist nicht für langfristiges VPS-Hosting im produktiven Einsatz gedacht, bei dem es mehr auf Zuverlässigkeit und Überwachbarkeit ankommt.

Für ein echtes Setup auf deinem Contabo-Rechner solltest du eine eigene PostgreSQL 17+ Instanz laufen lassen und Paperclip per DATABASE_URL darauf verweisen. Du kannst einen selbst gehosteten Postgres-Server direkt auf demselben Ubuntu VPS oder auf einem separaten Datenbank-VPS installieren und dann einen Connection-String wie postgres://user:password@host:5432/dbname nutzen, damit die Orchestrierungssoftware alle Unternehmens-, Agenten- und Audit-Daten in dieser externen Postgres-Instanz speichert, anstatt in der eingebetteten Datenbank.

Sobald Postgres bereit ist, holst du dir den neuesten Code von Paperclip-GitHub auf deinen Contabo VPS. Ein typisches Vorgehen auf Ubuntu ist:

cd /opt
git clone https://github.com/paperclipai/paperclip.git
cd paperclip

Paperclip liest die meisten Deployment-Einstellungen aus Umgebungsvariablen aus, die oft über eine .env-Datei oder die Env-Konfiguration deiner Container-Plattform verwaltet werden. Setz mindestens eine DATABASE_URL, die auf deine selbst gehostete Postgres-Instanz zeigt, plus Authentifizierungs-Secrets und optionale LLM-API-Keys (zum Beispiel ANTHROPIC_API_KEY für Claude oder andere Anbieter-Keys), damit deine KI-Paperclip-Agentenadapter mit externen Modellen kommunizieren können, während die KI-Orchestrierungsplattform selbst vollständig selbst gehostet auf deinem VPS bleibt.

Wenn du Docker nutzt, starte die Paperclip-App, indem du Folgendes im geklonten Repository auf deinem Contabo VPS ausführst:

docker compose up -d

Die Container starten dann das Web-Interface, die Background-Worker und alle anderen Dienste aus der Compose-Datei. Beim Weg über npx paperclipai onboard startet der Server automatisch nach dem Onboarding, du brauchst also keinen extra Befehl zum Deployen. Standardmäßig läuft er auf localhost, die Verbindung klappt also nur über einen SSH-Tunnel. Denk dran, dass der Server im Vordergrund läuft und die Shell aktiv bleiben muss, solange paperclipai onboard oder run aktiv sind. Du kannst sie aber auch als System-Dienst einrichten und ausführen.

Sobald dein Paperclip-Server auf Ubuntu läuft, sicher ihn mit einer Firewall und HTTPS ab, damit deine selbst gehosteten KI-Agenten und das Dashboard nicht ungeschützt im Netz stehen. Auf einem Contabo VPS nutzt du dafür am besten UFW als Firewall und Nginx als Reverse-Proxy vor der Paperclip-App (Port 3100).

Aktiviere zuerst UFW und erlaube nur SSH, HTTP und HTTPS:

apt install -y ufw
ufw allow ssh
ufw allow http
ufw allow https
ufw enable

Installiere dann Nginx und richte ihn so ein, dass er deine Domain an Paperclip (http://localhost:3100) weiterleitet – so sieht niemand den internen Port. Hol dir zum Schluss mit Certbot ein kostenloses Let’s Encrypt-Zertifikat, um deine selbst gehostete Paperclip-Orchestrierungsplattform über HTTPS bereitzustellen, damit der gesamte Datenverkehr zu deiner Plattform verschlüsselt bleibt, während sie auf deinem Contabo VPS läuft.

Zusätzlich zur UFW auf dem Server selbst bietet Contabo eine kostenlose Netzwerk-Firewall an, die du direkt im Customer Control Panel verwalten kannst. Dort legst du Regeln für den Datenverkehr fest (zum Beispiel, um nur HTTP/HTTPS und SSH zu deinem Paperclip-Server zu erlauben), noch bevor die Verbindungen überhaupt deinen VPS erreichen, was eine zusätzliche Sicherheitsebene ohne Zusatzkosten bedeutet.

Du kannst über einen SSH-Tunnel von deinem lokalen Rechner aus auf das Dashboard zugreifen. Die „Message of the Day“ (MOTD) führt dich durch das Setup.

Im Dashboard legst du deine „Firma“ fest und erstellst Agenten mit verschiedenen Rollen und Adaptern. Du könntest zum Beispiel mit einem CEO-KI-Agenten starten, der per MCP mit Claude verbunden ist, und dann Entwickler-Agenten hinzufügen, die Tickets bearbeiten.

Wenn du das 2026 auf Contabo nutzt, kannst du deine Ressourcen für KI-Agenten jederzeit skalieren – entweder per Upgrade oder indem du Postgres auf einen eigenen VPS auslagerst. Das Ergebnis ist eine Plattform, die du voll kontrollierst, statt einer geschlossenen SaaS-Lösung, bei der du Ressourcenverbrauch oder Datenströme nicht anpassen kannst.

Paperclip plus ein Contabo VPS gibt dir eine praktische Möglichkeit, heute mit KI-Paperclip zu experimentieren und im Laufe der Zeit in ernsthaftere Projekte reinzuwachsen. Du bekommst eine Open-Source-Orchestrierungssoftware, die Agenten wie ein Unternehmen koordiniert, und eine Infrastruktur, die du anpassen oder umziehen kannst, wenn sich deine Anforderungen ändern.

Wähle einen Contabo VPS oder VDS, der zu deinem geplanten Arbeitsaufwand passt, folge den Ubuntu-Schritten von oben und schon bist du bereit, Paperclip für echte KI-Projekte statt nur für kleine Demos zu hosten.