Skip to content

Installing AI Controller

This guide provides instructions for installing AI Controller in your environment. AI Controller can be deployed using Docker or installed natively on your system.

System Requirements

  • CPU: 4 cores minimum (8+ recommended for production)
  • RAM: 8GB minimum (16GB+ recommended for production)
  • Storage: 20GB minimum for installation and logs
  • Operating System: Ubuntu 24.04 LTS or compatible Linux distribution, Windows Server 2019+
  • Database: MySQL 8.0+
  • Additional Services: Redis for caching

Installation Options

AI Controller offers two primary installation methods:

  1. Docker Installation - Recommended for most users
  2. Installing directly on your operating system:

Pre-Installation Checklist

Before installing AI Controller, ensure you have:

  • [ ] Administrator access to the target system
  • [ ] API keys for the LLM providers you plan to use
  • [ ] Network access to LLM provider endpoints
  • [ ] Ports 9090 (AI Controller API) and 80/443 (Web interface) available
  • [ ] A valid AI Controller license key (if applicable)
  • [ ] Sufficient disk space for installation and logs
  • [ ] Docker installed (for Docker deployment method)
  • [ ] MySQL and Redis available or installable

Post-Installation Verification

After installing AI Controller, verify your installation by:

  1. Accessing the web interface at https://<your-server>:9090
  2. Logging in with the default credentials (admin/admin)
  3. Changing the default password
  4. Adding your LLM provider credentials
  5. Testing a sample request

Deployment Considerations

When planning your AI Controller deployment, consider:

  • Security: Ensure your AI Controller instance is properly secured, especially if accessible from the internet
  • Scaling: For high-volume environments, consider load balancing across multiple instances
  • Backup: Implement regular database backups to prevent data loss
  • Monitoring: Set up system monitoring to track performance and usage
  • Network: Ensure reliable connectivity to LLM provider endpoints

Next Steps

After successful installation, proceed to:

Updated: 2025-05-15