Prerequisites
Docker, ports, and API keys you’ll need before you start.
Pulling the images
Authenticate to Docker Hub and pull the RELAI images.
Configuration
Set up your
.env file and generate the required secrets.Choosing an LLM provider
Use OpenAI, Azure OpenAI, AWS Bedrock, Anthropic, or another supported provider.
Starting the services
Bring the stack up with Docker Compose.
What gets deployed
1
Database
A MySQL container that stores application data.
2
Redis
A Redis container used as the Celery message broker.
3
Backend
The RELAI backend, served with Uvicorn, plus one-off migration and
bootstrap containers that run on startup.
4
Celery worker
Runs background jobs (queued via Redis) using the same backend image.
5
Dashboard
The RELAI dashboard, a static frontend served by nginx.
Looking for a production-scale, multi-node deployment instead? Contact
RELAI — there’s a Kubernetes/Helm path for that. This guide covers the
single-node Docker Compose path only.