Self-Hosting Guide

Deploy Reloop on your own infrastructure with Docker, Kubernetes, or bare metal—your data stays on your network.

Before you begin

Ensure your environment meets minimum requirements.

Hardware

  • 4+ CPU cores recommended
  • 8 GB RAM minimum (16 GB for production)
  • 50 GB SSD storage

Software

  • Docker & Docker Compose
  • PostgreSQL, Redis, ClickHouse
  • SMTP server (Postfix) for outbound mail

Installation methods

Choose the path that fits your deployment.

Docker Compose (Recommended)

Fastest way to run Reloop locally or on a single server.

# Clone the repository
git clone https://github.com/reloop-labs/reloop.git
cd reloop

# Copy environment file
cp .env.example .env

# Start all services
docker compose up -d

Kubernetes

Production deployments with Helm charts and HA configurations.

# Add Helm repository
helm repo add reloop https://charts.reloop.com
helm repo update

# Install Reloop
helm install reloop reloop/reloop

Environment variables

Essential settings for a production deployment.

DATABASE_URL=postgresql://user:pass@localhost:5432/reloop
REDIS_URL=redis://localhost:6379
SMTP_HOST=smtp.yourdomain.com
SMTP_PORT=587
SMTP_USER=your-email@domain.com
RELOOP_API_KEY=your-secret-key

Ready to self-host?
You're in control.

Fork the repository, follow the guide, and join the community if you need help.