How to Self-Host Paperclip on a Contabo VPS in 2026 | Contabo Blog

Learn how to self-host Paperclip AI – the open‑source AI orchestration platform – on a Contabo VPS in 2026, using Ubuntu and Postgres. By the end, you’ll have a working Paperclip VPS secured over HTTPS. Then you’re ready to run AI agents as part of your own orchestration platform.

Paperclip is an open‑source AI orchestrator software that lets you run a whole “AI Paperclip company” composed of Paperclip AI agents with roles, goals, and budgets. Instead of a single chatbot, you define an org chart (CEO, engineers, marketers), then let Paperclip AI coordinate their work on shared projects.

Agents connect via adapters, for example Claude Code or other CLI‑style environments, so Paperclip acts as an AI orchestrator on top of your preferred models and tools. The code lives on Paperclip GitHub, which means you can self-host, inspect, and extend it on your own infrastructure.

Paperclip self-hosted on a VPS gives you control over your data, cost, and runtime environment. You choose where the automation orchestration tools run, which LLM orchestration providers use, and how strict your governance rules and agent budgets should be.

Contabo is a strong fit for VPS for AI agents because you get predictable pricing, generous RAM and storage, and EU data centers for GDPR-compliant AI agent hosting. If you want a European VPS for self-hosting, hosting Paperclip in an EU datacenter while calling out to external APIs like Claude or Hermes is straightforward.

Paperclip is a Node.js app with Postgres, so you need enough CPU/RAM for the web app, database, and Docker. Let’s look at what a Paperclip AI VPS server needs in terms of server requirements and setup

For a development or small internal deployment on Ubuntu, you can run it on hardware as minimal as:

• 2 vCPU
• 4 GB RAM
• 10 GB SSD storage
• Ubuntu 24.04 LTS

This is enough to try Paperclip AI with a handful of agents and an embedded or local Postgres instance. In Contabo terms, an entry‑level plan for VPS hosting will have plenty of ressources for your initial AI Paperclip plans.

For most teams, any Contabo Cloud VPS is a comfortable starting point for Paperclip. It gives you enough CPU, RAM, and fast NVMe storage to evaluate the Paperclip AI, build a sandbox, and even support small team workloads without overcommitting budget.

When Paperclip becomes part of a larger, always‑on production setup, moving to a Contabo Cloud VDS S is usually the safer long‑term choice. VDS plans provide dedicated resources and more predictable performance than shared VPS instances, which matters once your AI orchestration platform is running critical agents and jobs around the clock.

The steps below assume a fresh Ubuntu 22.04/24.04 VPS and a basic comfort level with SSH and the shell.

First up, you will need a VPS – skip this step if you already have one ready to be used. Order a Contabo VPS in your preferred region. If GDPR is relevant to your use case, an European VPS for self-hosting is a good fit. Choose a plan that matches the requirements above, select Ubuntu as the OS, then connect from your local machine:

ssh root@SERVER_IP

From here on, this VPS is your Paperclip server and will host both the web app and database unless you offload Postgres elsewhere.

You have two main options to get Paperclip AI running on your Contabo VPS: a one‑command npx quickstart for fast testing, and a Docker deployment for long‑term use.

Fastest first run – npx paperclipai onboard
If you just want to see the Paperclip app in action, first refresh your local package index install Node.js on your Ubuntu VPS:

sudo apt update
sudo apt install nodejs

Confirm with Y, then install the Node.js package manager:

sudo apt install npm

Confirm with Y, then run:

npx paperclipai onboard --yes

More details can be found on the official Paperclip GitHub page.

Production path – Paperclip with Docker on Ubuntu
For a stable, repeatable Paperclip deploy on your Contabo VPS, use Docker and Docker Compose. After installing Docker, you can use the Paperclip GitHub compose file and configure your environment file, then start the stack with docker compose up -d, which gives you a containerized Paperclip self-hosted orchestration platform suitable for ongoing workloads.

By default, Paperclip uses an embedded PostgreSQL instance when no DATABASE_URL is set, so you can complete your first run without touching databases at all. This zero‑config mode is perfect for local development and quick evaluation, but it’s not designed for long‑term, production VPS hosting where reliability and observability matter more.

For a production Postgres VPS deployment on your Contabo server, you should run a dedicated PostgreSQL 17+ instance and point Paperclip at it via DATABASE_URL. You can install a self-hosted Postgres server directly on the same Ubuntu VPS or on a separate database VPS, then use a connection string like postgres://user:password@host:5432/dbname so the orchestrator software persists all company, agent, and audit data in that external Postgres instead of the embedded database.

With Postgres ready, fetch the latest code from Paperclip GitHub onto your Contabo VPS. A common pattern on Ubuntu is:

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

Paperclip reads most deployment settings from environment variables, often managed via a .env file or your container platform’s env configuration. At minimum, set a DATABASE_URL pointing to your self‑hosted Postgres instance, plus authentication secrets and optional LLM API keys (for example ANTHROPIC_API_KEY for Claude or other provider keys) so your AI Paperclip agent adapters can talk to external models while the AI orchestration platform itself stays fully self‑hosted on your VPS.

If you’re using Docker, start the Paperclip App by running

docker compose up -d

in the cloned repository on your Contabo VPS. The containers will boot the web UI, background workers, and any supporting services defined in the compose file.

For the npx paperclipai onboard path, the local server is started automatically once onboarding finishes, so you don’t need an extra paperclip deploy command. It will run by default on localhost and connection will only work with an SSH tunnel. Bear in mind that the server will run in the foreground, and both the paperclipai onboard and paperclipai run commands will require the shell to stay active. They can also be run as a service.

Once your Paperclip server is running on Ubuntu, lock it down with a firewall and HTTPS so your self-host AI agents and dashboard are not exposed more than necessary. On a Contabo VPS, the typical stack is UFW for the host firewall plus Nginx as a reverse proxy in front of the Paperclip app on port 3100.

Start by enabling UFW and allowing only SSH, HTTP, and HTTPS:

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

Next, install Nginx and configure it as a reverse proxy that forwards your domain to Paperclip on http://localhost:3100, so users never see the internal port. Finally, add a free Let’s Encrypt certificate with Certbot (certbot –nginx -d your-domain.example) to serve your Paperclip self-hosted orchestration platform over HTTPS, keeping traffic to your platform encrypted while it runs on your Contabo VPS.

On top of UFW on the server itself, Contabo also includes a free, network‑level firewall you can manage from the Customer Control Panel. From there, you define traffic rules (for example allowing only HTTP/HTTPS and SSH to your Paperclip server) before connections even reach your VPS, which adds another layer of protection without extra cost.

You can access the dashboard through SSH on your local machine’s localhost. The MOTD will guide the user through setup.

Inside the dashboard, you define your “company” and create agents with different roles and adapters. For example, you might start with a CEO‑style paperclip ai agent connected to Claude via MCP, then add engineering agents that pick up tickets from the board.

Running this on Contabo in 2026 means you can scale your VPS for AI agents as needs grow – either by upgrading the VPS tier or by splitting Postgres to its own Postgres VPS. The result is an orchestration platform you fully control, instead of a closed SaaS where you can’t tune resource usage or data flows.

Paperclip plus a Contabo VPS gives you a practical way to experiment with AI Paperclip today and grow into more serious deployments over time. You get open‑source orchestration software that orchestrates agents like a company, and infrastructure you can resize or move when your requirements change.

Pick a Contabo VPS or VDS that matches your projected workload, follow the Ubuntu steps above, and you’ll be ready to host Paperclip for real AI projects instead of toy demos.