Skip to content

Easy8 AI Knowledge assistant PRO / Easy8 AI Helpdesk - Cloud AI

Use this guide when:

  • the customer uses Easy8 AI Knowledge assistant PRO or Easy8 AI Helpdesk
  • ChromaDB runs on the customer infrastructure
  • LLM and embeddings come from cloud providers

Easy8 AI Knowledge assistant PRO and Easy8 AI Helpdesk share the same infrastructure requirements.

Required services

This scenario requires:

  • chain
  • celery
  • chroma
  • cloud LLM provider
  • cloud embeddings provider

Environment configuration

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

In the standard package deployment, you can usually leave EASY_AI_PUBLIC_URL, EASY_AI_CHAIN_HOST, EASY_AI_CHAIN_PORT, and EASY_AI_CHAIN_URL unset. Easy8 then derives the public AI URL from the main Easy8 application URL and uses http://chain:8000 for internal chain communication.

OpenAI example

OPENAI_API_KEY=sk-...

This enables both LLM access and OpenAI embeddings.

For this scenario, the cloud provider variables are usually the only additional Easy8 settings needed.

Azure OpenAI example

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

Optional internal Chroma override

If needed, use:

CHROMADB_URL=http://chroma:8000

Installation steps

  1. Add the required environment variables to the Easy8 deployment .env file.
  2. Verify the package includes docker-compose_easy_ai.yml.
  3. Run:
docker compose run --rm app install
docker compose up -d
  1. Confirm app, chain, chroma, celery, and redis are running.

Notes

  • for Docker internal communication, Chroma should use http://chroma:8000
  • do not use host port 8001 for internal container-to-container communication unless the deployment explicitly requires it