System Requirements
This guide outlines the minimum and recommended system requirements for self-hosting Clipron AI on your own infrastructure.Overview
Clipron AI is designed to run on modern Linux servers with support for Docker containerization or direct installation. The platform consists of a React frontend, FastAPI backend, and requires several external API integrations.Server Requirements
Minimum Requirements
CPU
2 vCPUs
- x86_64 architecture
- 2.0 GHz or higher
- Supports up to 10 concurrent analyses
Memory
4 GB RAM
- 2 GB for backend services
- 1 GB for database
- 1 GB for system overhead
Storage
20 GB SSD
- 10 GB for application files
- 5 GB for database
- 5 GB for logs and temporary files
Network
100 Mbps
- Stable internet connection
- Low latency to AI API providers
- SSL/TLS support required
Recommended Requirements
CPU
4+ vCPUs
- x86_64 architecture
- 3.0 GHz or higher
- Supports 50+ concurrent analyses
Memory
8+ GB RAM
- 4 GB for backend services
- 2 GB for database
- 2 GB for caching and buffers
Storage
100+ GB SSD
- 20 GB for application files
- 50 GB for database growth
- 30 GB for logs and backups
Network
1 Gbps
- High-speed internet connection
- CDN integration support
- Load balancer compatibility
Operating System Support
Supported Distributions
- Ubuntu (Recommended)
- CentOS/RHEL
- Debian
- Docker
Ubuntu 20.04 LTS or newer
- Best tested and supported
- Automated installation scripts available
- Long-term support and security updates
- Package manager compatibility
Unsupported Systems
Software Dependencies
Required Software
Python 3.9+
Python 3.9+
Backend runtime environment
- Python 3.9, 3.10, or 3.11 supported
- Virtual environment support (venv or conda)
- pip package manager
- Development headers for compilation
Node.js 18+
Node.js 18+
Frontend build environment
- Node.js 18 LTS or newer
- npm or yarn package manager
- Build tools for native modules
- TypeScript support
Database
Database
Data storage
- SQLite 3.35+ (development/small deployments)
- PostgreSQL 13+ (recommended for production)
- MySQL 8.0+ (alternative option)
Web Server
Web Server
HTTP server and reverse proxy
- Nginx 1.18+ (recommended)
- Apache 2.4+ (alternative)
- SSL/TLS certificate support
- WebSocket proxy support
Optional Software
Redis
Caching and session storage
- Improves performance
- Required for multi-server deployments
- Session persistence
Docker
Containerization
- Simplified deployment
- Better resource isolation
- Easier scaling
Certbot
SSL certificate management
- Automatic SSL certificate renewal
- Let’s Encrypt integration
- HTTPS enforcement
Monitoring Tools
System monitoring
- Prometheus + Grafana
- System resource monitoring
- Application performance tracking
External API Requirements
Required API Keys
AI Model Providers
AI Model Providers
At least one required, all recommended
- Google Gemini API: Primary analysis engine
- DeepSeek API: Code-specialized analysis
- Anthropic Claude API: Advanced reasoning
- OpenAI API: Fallback and specialized tasks
Authentication Providers
Authentication Providers
OAuth integration
- Google OAuth: User authentication
- GitHub OAuth: Repository access and user auth
- Both providers recommended for best user experience
Payment Processing
Payment Processing
Required for paid features
- Stripe API: Payment processing
- Webhook endpoint: Payment confirmations
- SSL certificate required for webhooks
API Rate Limits
Consider these rate limits when planning your deployment:| Provider | Free Tier | Paid Tier | Notes |
|---|---|---|---|
| Google Gemini | 15 RPM | 300+ RPM | Varies by model |
| DeepSeek | 60 RPM | 600+ RPM | Code-optimized |
| Anthropic | 5 RPM | 50+ RPM | Higher quality |
| OpenAI | 3 RPM | 60+ RPM | GPT-4 limited |
Network Requirements
Inbound Connections
- HTTP/HTTPS
- SSH
- Webhooks
Web traffic
- Port 80 (HTTP) - redirects to HTTPS
- Port 443 (HTTPS) - main application
- SSL certificate required
Outbound Connections
AI API Providers
AI API Providers
Required for analysis functionality
- api.openai.com (OpenAI)
- generativelanguage.googleapis.com (Google)
- api.deepseek.com (DeepSeek)
- api.anthropic.com (Anthropic)
Authentication Services
Authentication Services
OAuth and user management
- accounts.google.com (Google OAuth)
- github.com (GitHub OAuth)
- oauth2.googleapis.com (Google APIs)
Payment Services
Payment Services
Billing and payments
- api.stripe.com (Stripe API)
- js.stripe.com (Stripe.js)
- checkout.stripe.com (Checkout)
Security Requirements
SSL/TLS Configuration
1
Certificate Acquisition
Obtain SSL certificates from a trusted CA or use Let’s Encrypt
2
Strong Cipher Suites
Configure modern TLS 1.2+ with strong encryption
3
HSTS Headers
Enable HTTP Strict Transport Security
4
Certificate Renewal
Set up automatic certificate renewal
Firewall Configuration
Inbound Rules
- Allow HTTP (80) and HTTPS (443)
- Allow SSH (22) from admin IPs only
- Block all other inbound traffic
Outbound Rules
- Allow HTTPS (443) to API providers
- Allow DNS (53) for name resolution
- Allow NTP (123) for time sync
Performance Considerations
Scaling Factors
Concurrent Users
Concurrent Users
User capacity planning
- 1 vCPU per 25 concurrent users
- 1 GB RAM per 50 concurrent users
- Database connection pooling required
Analysis Volume
Analysis Volume
Processing capacity
- 1 vCPU per 5 concurrent analyses
- 2 GB RAM per 10 concurrent analyses
- Network bandwidth for API calls
Data Storage
Data Storage
Storage growth planning
- 10 MB per analysis result
- 100 MB per 1000 users
- Regular backup storage needs
Optimization Recommendations
Compliance and Regulations
Data Protection
Industry-Specific Requirements
- Healthcare: HIPAA compliance for medical code
- Finance: PCI DSS for payment processing
- Government: FedRAMP for federal agencies
- Enterprise: Custom security requirements
Self-hosted deployments are responsible for their own compliance. Our hosted solution at clipron.com includes compliance certifications.