Skip to main content
Install the co-mind.ai platform on your own servers using the Co-Mind AI Platform Manager CLI.

​
System Requirements

  • OS: Ubuntu 22.04+ / Debian 12+ / RHEL 9+
  • CPU: 8+ cores recommended
  • RAM: 32 GB minimum, 64 GB recommended
  • Storage: 100 GB+ SSD
  • Network: Outbound HTTPS for image pulls (or air-gapped with pre-loaded images)

​
Prerequisites

Before you begin, ensure you have:
  1. A license file (license.lic) and license key — contact us to obtain one
  2. Root or sudo access on the target machine

​
Installation

1

Download the installer

Download the installer for your architecture:
2

Run the installer

This installs the comind CLI to /opt/comind/bin/comind and adds it to your PATH.
3

Initialize the platform

The init command will:
  • Validate your license
  • Pull the platform manifest
  • Generate environment configuration (auto-generates secrets, prompts for required values)
  • Pull all Docker images
The --key flag accepts either a file path or a raw key string.
4

Start the platform

All services will start. This may take a few minutes on first run as models are downloaded.
5

Create your admin account

Open your browser and navigate to:
On first visit, you’ll be redirected to the setup page where you create the initial admin account. No environment variables needed — just fill in your email and password.

​
Post-Install Configuration

​
Check service status

​
View logs

​
Common configuration

After the initial setup, you can configure optional features through the admin UI:
  • SSO / OAuth — Google and Microsoft sign-in
  • LDAP / Active Directory — Enterprise directory integration
  • Email (SendGrid) — Account confirmation and password recovery emails
  • AI Model Providers — Connect OpenAI, Anthropic, SambaNova, and other backends

​
Updating

To update to the latest version:

​
CLI Reference

​
Troubleshooting

On first run, some services may download additional resources. Run sudo comind status to check which services are affected and sudo comind logs for details.
The installer automatically installs Docker if it is not already present. If you still encounter issues, ensure your system meets the OS requirements and re-run the installer.
  • Ensure the --key flag points to the correct license key file
  • Check that your license hasn’t expired
  • Verify the license file hasn’t been modified
  • Ensure port 3000 is open in your firewall
  • Check that the app container is running: sudo comind status
  • View logs for errors: sudo comind logs comind-app

​
Need Help?