Self-Hosting SpiderIQ: Docker Compose on a Single €9 VPS

Some agencies can't use cloud SaaS — regulatory requirements, data residency, or just strong opinions about ownership. That's why SpiderIQ offers a fully self-hosted option. Here's how to get it running on a single €9/month Hetzner VPS.

Prerequisites

• A VPS with at least 4GB RAM and 2 vCPUs (Hetzner CX22 works perfectly)

• Ubuntu 24.04 LTS

• A domain pointed to your server's IP

• Docker and Docker Compose v2 installed

The Stack

Our Docker Compose file spins up six services:

• PostgreSQL 16 — primary data store

• Redis 7 (cluster mode) — caching, rate limiting, job queues

• Celery workers (x2) — async task execution for scraping and email delivery

• FastAPI gateway — the API layer that MCP tools call

• Caddy — automatic TLS via Let's Encrypt, reverse proxy

• SpiderIQ Agent — the orchestration engine

Quick Start

git clone https://github.com/spideriq/self-hosted.git
cd self-hosted
cp .env.example .env
# Edit .env with your domain and license key
docker compose up -d

The first boot takes about 90 seconds. Caddy will automatically provision your TLS certificate. Once healthy, your agent is available at https://your-domain.com/agent.

Performance

On the €9 CX22, we benchmarked: 12 concurrent MCP tool calls, 500 email verifications/minute, and 3 simultaneous scraping jobs. For teams under 5 users, this is more than enough.

Backups

We include a daily backup cron that dumps PostgreSQL and uploads to S3-compatible storage. Retention: 14 days by default, configurable via BACKUP_RETENTION_DAYS.

Need help? Join our self-hosted Discord channel or email infra@spideriq.ai.