Requirements
Hardware
Minimum
| Component | Specification |
| CPU | 2 cores |
| Memory | 4 GB RAM |
| Storage | 20 GB SSD |
Recommended (Production)
| Component | Specification |
| CPU | 4+ cores |
| Memory | 8+ GB RAM |
| Storage | 50+ GB SSD |
| Network | 100+ Mbps |
Software
Operating System
- Linux (Ubuntu 20.04+, Debian 11+, RHEL 8+)
- macOS 12+ (development only)
- Windows with WSL2 (development only)
Runtime
| Component | Version |
| Go | 1.23+ (for building from source) |
| Docker | 24.0+ |
| Docker Compose | 2.20+ |
Services
| Service | Version | Purpose |
| PostgreSQL | 12+ (15 recommended) | Primary database |
| Redis | 6+ (7 recommended) | Caching |
| NATS | 2.9+ (2.10 recommended) | Message queue |
Network
Ports
| Port | Service | Required |
| 8080 | API Server | Yes |
| 5432 | PostgreSQL | Internal |
| 6379 | Redis | Internal |
| 4222 | NATS | Internal |
Firewall Rules
Inbound: - 443 (HTTPS) from public - 8080 (API) from load balancer
Outbound: - 443 to AI providers (Anthropic, OpenAI) - 443 to Metricool API - 443 to Clerk (authentication)
External Services
Required
| Service | Purpose |
| Clerk | Authentication |
| Metricool | Publishing |
AI Providers (at least one)
| Provider | API Key Required |
| Anthropic (Claude) | Yes |
| OpenAI | Yes |
| Google (Gemini) | Yes |
Storage
Database
- PostgreSQL 12+ with standard extensions
- Minimum 10GB for small deployments
- Plan 1GB per 10,000 content items
- S3-compatible storage for generated images
- Estimated 50KB-500KB per image
- CDN recommended for production
Scaling Guidelines
| Users | API Instances | Workers | Database |
| 1-10 | 1 | 1 | 2 vCPU, 4GB |
| 10-50 | 2 | 2 | 4 vCPU, 8GB |
| 50-200 | 3 | 4 | 8 vCPU, 16GB |
| 200+ | 4+ | 6+ | 16+ vCPU, 32GB+ |