Skip to content

System Requirements for AI Controller

This document outlines the hardware, software, and network requirements for deploying AI Controller in various environments. Understanding these requirements will help you plan for a successful implementation and ensure optimal performance.

Hardware Requirements

Hardware requirements vary based on your deployment scale and expected usage patterns.

Minimum Requirements

For development, testing, or small-scale deployments:

Component Requirement
CPU 4 cores
Memory 8GB RAM
Storage 10GB free space
Network 100 Mbps Ethernet

For production environments with moderate usage:

Component Requirement
CPU 8+ cores
Memory 16GB+ RAM
Storage 40GB+ SSD storage
Network 1 Gbps Ethernet

High-Performance Requirements

For large-scale deployments with high traffic:

Component Requirement
CPU 16+ cores
Memory 32GB+ RAM
Storage 100GB+ NVMe SSD storage
Network 1 Gbps Ethernet

Resource Considerations

When planning your deployment, consider these factors:

  • Concurrent Users: Each concurrent user requires approximately 50-100MB of memory
  • Request Volume: Higher request volumes require more CPU cores
  • Response Caching: Caching requires additional memory but improves performance
  • Log Storage: Long-term log retention requires more storage capacity

Software Requirements

Operating System

AI Controller supports the following operating systems (64-bit architecture required):

For Docker Deployment

  • Linux: Any distribution that supports Docker 24.0+ and Docker Compose 2.0+
  • Windows: Windows 10/11 Pro/Enterprise or Windows Server 2019/2022 with Docker Desktop
  • macOS: macOS 11.0+ with Docker Desktop (development only)

For Native Deployment

  • Linux: Ubuntu 22.04/24.04 LTS or compatible Linux distribution
  • Windows: Windows Server 2019/2022 or Windows 10/11 Pro/Enterprise

Required Software Components

Docker Deployment

  • Docker Engine 24.0+
  • Docker Compose 2.0+

Native Linux Deployment

  • Ubuntu 22.04/24.04 LTS or compatible Linux distribution
  • Root or sudo access
  • MySQL 8.0+
  • Redis 6.0+

Native Windows Deployment

  • Windows Server 2019 or newer or Windows 10 or newer
  • Administrator access
  • MySQL 8.0+
  • Redis 6.0+
  • Microsoft Visual C++ Redistributable packages

Network Requirements

Port Requirements

AI Controller requires the following network ports:

Port Protocol Purpose Required For
9090 HTTPS/HTTP Web interface and AIC API External access
3306 TCP MySQL database Internal communication
6379 TCP Redis ..... Internal communication

Note: All ports can be configured and customized

Firewall Considerations

  • Allow outbound connections to LLM provider APIs
  • Allow inbound connections to ports 9090 from user networks
  • Restrict direct access to internal ports (3306, 6379)

SSL/TLS Requirements

AI Controller requires SSL/TLS certificates for secure communications:

  • Valid SSL certificate for production environments
  • Self-signed certificates acceptable for development/testing
  • Support for TLS 1.2+ recommended

Browser Compatibility

The AI Controller web interface is compatible with modern web browsers:

Browser Minimum Version
Google Chrome 90+
Microsoft Edge 90+
Mozilla Firefox 90+
Safari 14+

Updated: 2025-05-27