Skip to content

Knowledge assistant PRO and Helpdesk with cloud AI

Use this guide for Easy8 AI Knowledge assistant PRO or Easy8 AI Helpdesk when ChromaDB runs on your infrastructure and the LLM and embeddings come from a cloud provider. Both products have the same infrastructure requirements.

Before you start, read Prerequisites.

Environment configuration

Set the variables from Common configuration, then add the cloud provider settings.

You can leave EASY_AI_PUBLIC_URL, EASY_AI_CHAIN_HOST, EASY_AI_CHAIN_PORT and EASY_AI_CHAIN_URL unset; see Easy8-to-Chain URLs.

OpenAI (one key enables the LLM and the embeddings):

OPENAI_API_KEY=sk-...

Azure OpenAI:

AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com/

The Chroma address defaults to http://chroma:8000. Set it only to override:

CHROMADB_URL=http://chroma:8000

Inside Docker, use the Chroma address on the internal network. Do not use a host port such as 8001 unless your deployment requires it.

Installation steps

  1. Add the environment variables to the Easy8 .env file.
  2. Check that the package includes docker-compose_easy_ai.yml.

  3. Install and start Easy8:

    docker compose run --rm app install
docker compose up -d

  4. Check that app, chain, chroma, celery and redis are running.

  5. Add the reverse proxy rule from Nginx configuration. The browser reaches Chain through /ai/chain in every product, so PRO and Helpdesk need the rule too.

  6. Open both public Chain URLs:

    • https://your.easy.host/ai/chain/sys/monitoring.json
    • https://your.easy.host/ai/chain/api/info

    The info endpoint must show the embeddings provider and the Chroma URL. See Verification and troubleshooting.