> ## 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.

# Installation

> Step-by-step guide to install and configure the co-mind.ai platform on your own infrastructure.

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

## System Requirements

<Tabs>
  <Tab title="x86_64 (amd64)">
    * **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)
  </Tab>

  <Tab title="ARM64 (aarch64)">
    * **OS:** Ubuntu 22.04+ (ARM64) / NVIDIA DGX OS
    * **CPU:** ARM64 processor (NVIDIA Grace, Apple Silicon, AWS Graviton)
    * **RAM:** 32 GB minimum, 64 GB recommended
    * **Storage:** 100 GB+ SSD
    * **GPU (optional):** NVIDIA GPU with CUDA 12+ and nvidia-container-toolkit
  </Tab>
</Tabs>

## Prerequisites

Before you begin, ensure you have:

1. A **license file** (`license.lic`) and **license key** — [contact us](https://co-mind.ai/contact/) to obtain one
2. **Root or sudo access** on the target machine

## Installation

<Steps>
  <Step title="Download the installer">
    Download the installer for your architecture:

    <Tabs>
      <Tab title="x86_64 (amd64)">
        ```bash theme={null}
        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
        ```
      </Tab>

      <Tab title="ARM64 (aarch64)">
        ```bash theme={null}
        curl -fsSL -o comind-installer.sh https://github.com/co-mind-ai/comind-release/releases/latest/download/comind-linux-arm64.sh
        chmod +x comind-installer.sh
        ```
      </Tab>
    </Tabs>
  </Step>

  <Step title="Run the installer">
    ```bash theme={null}
    sudo ./comind-installer.sh
    ```

    This installs the `comind` CLI to `/opt/comind/bin/comind` and adds it to your PATH.
  </Step>

  <Step title="Initialize the platform">
    ```bash theme={null}
    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

    <Note>
      The `--key` flag accepts either a file path or a raw key string.
    </Note>
  </Step>

  <Step title="Start the platform">
    ```bash theme={null}
    sudo comind start
    ```

    All services will start. This may take a few minutes on first run as models are downloaded.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Post-Install Configuration

### Check service status

```bash theme={null}
sudo comind status
```

### View logs

```bash theme={null}
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:

```bash theme={null}
sudo comind update
```

## CLI Reference

| Command          | Description              |
| ---------------- | ------------------------ |
| `comind init`    | Initialize the platform  |
| `comind start`   | Start all services       |
| `comind stop`    | Stop all services        |
| `comind restart` | Restart all services     |
| `comind status`  | Show service status      |
| `comind logs`    | View service logs        |
| `comind update`  | Update to latest version |
| `comind backup`  | Full system backup       |
| `comind restore` | Restore from backup      |
| `comind version` | Show installed version   |

## Troubleshooting

<AccordionGroup>
  <Accordion title="Services fail to start">
    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.
  </Accordion>

  <Accordion title="Docker not found">
    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.
  </Accordion>

  <Accordion title="License validation failed">
    * 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
  </Accordion>

  <Accordion title="Cannot access the web UI">
    * 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`
  </Accordion>
</AccordionGroup>

## Need Help?

* **Support:** [support@co-mind.ai](mailto:support@co-mind.ai)
* **License inquiries:** [Contact us](https://co-mind.ai/contact/)