Skip to content

On-Premises Installation

This section is the installation entry point for Easy8 AI in customer-managed infrastructure.

Use it when Easy8 is deployed from the standard package and AI services are installed together with it.

It is written for server administrators who need to choose the correct deployment scenario, complete the installation, and verify that the environment works.

What is included in the delivered package

The standard Easy8 package should contain:

  • the main Easy8 docker-compose.yml
  • docker-compose_easy_ai.yml
  • environment variables that must be added to the main Easy8 .env file

The delivered package defines the actual Docker image names and tags. The guides in this section use example values for those images.

Before you choose a scenario

Keep these product and hosting differences in mind:

  • Easy8 AI Basic needs chain, celery, and an LLM provider
  • Easy8 AI Knowledge assistant PRO and Easy8 AI Helpdesk also need chroma and embeddings
  • Cloud AI means the LLM and embeddings come from cloud providers
  • Self-hosted AI means the customer also runs the LLM and optionally embeddings on their own infrastructure

For the standard package deployment, browser traffic usually goes to /ai/chain, while Easy8 itself talks to http://chain:8000 on the internal Docker network.

Easy8 and Chain must also share the same EASY_JWT_SECRET.

Choose the correct scenario

In this section, PRO products means Easy8 AI Knowledge assistant PRO and Easy8 AI Helpdesk.

Product tier

Product Requires
Easy8 AI Basic chain, celery, LLM
Easy8 AI Knowledge assistant PRO chain, celery, chroma, embeddings, LLM
Easy8 AI Helpdesk chain, celery, chroma, embeddings, LLM

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

AI hosting mode

Mode Customer hosts
Self-hosted AI Easy8, chain, celery, optional chroma, local LLM, local embeddings
Cloud AI Easy8, chain, celery, optional chroma; LLM and embeddings come from cloud providers

Minimum variables by scenario

Scenario Minimum additional variables
Basic + cloud AI OPENAI_API_KEY or AZURE_OPENAI_API_KEY + AZURE_OPENAI_ENDPOINT
Basic + self-hosted AI LLM_URL
PRO products + cloud AI OPENAI_API_KEY or AZURE_OPENAI_API_KEY + AZURE_OPENAI_ENDPOINT
PRO products + self-hosted AI LLM_URL, EMBEDDINGS_URL

For standard cloud AI deployments, the Easy8-to-Chain URL variables usually do not need to be set manually. Easy8 derives the public AI URL from the main Easy8 application setting on /settings, in the field Host name and path. Easy8 also defaults the internal chain URL to http://chain:8000.

Start here

Installation guides

After installation

Extra docs