Requirements
This page lists the hardware, software, and network requirements for self-hosting CleverThis.
Hardware (Docker Compose / single-server)
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU |
| RAM | 4 GB | 8 GB |
| Disk | 20 GB SSD | 100 GB SSD |
RAM usage scales with the number of concurrent Actor executions. Each Actor graph execution holds message context in memory while running. For workloads with large context windows or many concurrent users, increase RAM accordingly.
Hardware (Kubernetes)
For Kubernetes deployments, the resource requests per component are defined in the Helm chart values.yaml. See Kubernetes for details. Minimum viable cluster: 3 nodes × 4 vCPU / 8 GB RAM.
Software prerequisites
| Software | Minimum version | Notes |
|---|---|---|
| Docker Engine | 24.0 | With Docker Compose v2 (plugin, not standalone) |
| OS | Ubuntu 22.04 LTS / Debian 12 / RHEL 9 | Linux strongly recommended |
| PostgreSQL | 15 | Managed by the compose stack or external |
| Redis | 7 | Managed by the compose stack or external |
CleverThis does not support running on Windows Server. macOS is supported for local development only.
Network / open ports
| Port | Protocol | Service | Required |
|---|---|---|---|
| 80 | TCP | HTTP (redirects to HTTPS) | yes |
| 443 | TCP | HTTPS | yes |
| 5432 | TCP | PostgreSQL | internal only |
| 6379 | TCP | Redis | internal only |
Ports 5432 and 6379 should not be exposed to the public internet. Use a firewall or security group to restrict them to the Docker/Kubernetes network.
External services required
- LLM provider account(s) — at least one API key from OpenAI, Anthropic, Google, or another supported provider
- Stripe account — required for billing; see Stripe Configuration
- SMTP server — for sending email verification and invite emails
- Domain + TLS certificate — Let's Encrypt via certbot or an existing cert
Minimum spec testing results for various concurrent user loads are being added.