Installation Guide¶

Requirements¶

Requirement	Minimum	Recommended
OS	Ubuntu 20.04	Ubuntu 22.04 LTS
RAM	4 GB	8 GB
CPU	2 vCPU	4 vCPU
Disk	20 GB SSD	40 GB SSD
Docker	v20.10+	latest
Domain	Required	Required
License Key	Required	Required

Step 1 -- Get a License Key¶

Go to ragleap.com/pricing/#server-edition
Pick a plan (Free, Starter $9, Pro $79, Agency $149, Enterprise $399)
Pay via Razorpay
License key arrives by email instantly
Format: RAGL-XXXX-XXXX-XXXX-XXXX

Free plan requires no payment. Just run the installer and choose Free when prompted.

Step 2 -- Install Docker¶

Ubuntu / Debian:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker
docker --version

Mac: Download Docker Desktop from docker.com

Windows: See the Windows Installation Guide

Step 3 -- Run the Installer¶

curl -sSL https://install.ragleap.com/install.sh | bash

The installer will ask: Enter your license key: RAGL-XXXX-XXXX-XXXX-XXXX Enter domain: app.yourdomain.com Anthropic API Key: sk-ant-... Brevo API Key: xkeysib-... Admin email: [email protected]

Make sure your domain DNS A record points to this server IP before running. SSL is auto-generated via Let's Encrypt.

Database Extensions (Automatic)¶

The installer automatically enables these PostgreSQL extensions:

Extension	Purpose
pgvector	Vector embeddings for AI search
pg_trgm	Fuzzy text search
unaccent	Accent-insensitive search

No manual setup needed -- all handled by the installer.

Step 4 -- Verify¶

After install you will see: RagLeap is installed! App URL: https://app.yourdomain.com Admin Panel: https://app.yourdomain.com/selfhost/admin/ Django Admin: https://app.yourdomain.com/admin/

Step 5 -- Add API Keys¶

Go to Settings in your app and add:

Key	Where to get
Anthropic API Key	console.anthropic.com
Gemini API Key	aistudio.google.com
Telegram Bot Token	@BotFather on Telegram
WhatsApp Token	Meta Business Manager

Troubleshooting¶

Port 80/443 in use:

sudo lsof -i :80
sudo systemctl stop apache2

Docker permission denied:

sudo usermod -aG docker $USER
newgrp docker

SSL failed -- check DNS:

dig +short yourdomain.com
# Must return your server IP

Installer failed midway -- safe to re-run:

curl -sSL https://install.ragleap.com/install.sh | bash