Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.co-mind.ai/llms.txt

Use this file to discover all available pages before exploring further.

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:
curl -fsSL -o comind-installer.sh https://github.com/co-mind-ai/comind-release/releases/latest/download/comind-linux-amd64.sh
chmod +x comind-installer.sh
2

Run the installer

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

Initialize the platform

sudo comind init --license /path/to/license.lic --key /path/to/license.key
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

sudo comind start
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:
http://<your-server-ip>:3000
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

sudo comind status

​
View logs

sudo comind 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: 
sudo comind update

​
CLI Reference

CommandDescription
comind initInitialize the platform
comind startStart all services
comind stopStop all services
comind restartRestart all services
comind statusShow service status
comind logsView service logs
comind updateUpdate to latest version
comind backupFull system backup
comind restoreRestore from backup
comind versionShow installed version

​
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?