Deployment
Deployment
Deploy thinnestAI to your own infrastructure. Self-host the full platform on Docker, GCP, or your preferred cloud provider.
Deployment
thinnestAI can be self-hosted on your own infrastructure. This gives you full control over your data, compliance, and scaling.
Deployment Options
| Option | Best For | Complexity |
|---|---|---|
| Docker | Local development, small teams | Low |
| GCP Cloud Run | Production workloads | Medium |
| Custom | Advanced users with existing infrastructure | High |
Architecture Overview
A full thinnestAI deployment consists of:
| Component | Purpose | Required |
|---|---|---|
| Backend API | FastAPI server handling all API requests | Yes |
| PostgreSQL | Primary database with pgvector for embeddings | Yes |
| Redis | Caching, rate limiting, and task queues | Yes |
| Background Workers | Email, billing, campaigns, auto-topup | Yes (for full features) |
| Frontend | Next.js dashboard and management UI | Optional (use hosted dashboard) |
Minimum Requirements
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU |
| Memory | 4 GB | 8 GB |
| Storage | 20 GB | 50 GB+ |
| PostgreSQL | 15+ with pgvector | Managed service preferred |
| Redis | 6.0+ | Managed service preferred |
Quick Start
The fastest way to get running is with Docker:
git clone https://github.com/thinnestai/agno-platform.git
cd agno-platform
cp .env.example .env
# Edit .env with your configuration
docker-compose up -dSee Docker Deployment for the full guide.
Configuration
All configuration is done through environment variables. See the Environment Variables reference for the complete list.
The minimum required variables are:
# Database
PG_DB_URL=postgresql://user:password@localhost:5432/agno
# Encryption
ENCRYPTION_KEY=your-32-character-encryption-key
# At least one LLM provider
OPENAI_API_KEY=sk-your-openai-keyWhat's Next
- Docker Deployment — Get running locally in minutes.
- GCP Deployment — Production-ready deployment on Google Cloud.
- Environment Variables — Complete configuration reference.
- Monitoring — Set up observability and health checks.