1

Set up a PostgreSQL database

First, set up a PostgreSQL database (version 15 or higher). This can be on the same host or a separate server.

You'll need the following information for your database:

• Host address and port
• Database name
• Username and password with appropriate permissions

For production use, we recommend using a managed PostgreSQL service or properly configuring your self-hosted PostgreSQL instance with backups and security.

2

Log in to the private Docker Repository

Make sure Docker is installed on your host machine before running the following command:

docker login -u lunarycustomer

Then, paste your organization's access token, which will be provided by Lunary when your subscription is activated.

3

Create the Docker Compose file

Create a new directory for your Lunary installation and create a docker-compose.yml file with the following content:

services:
  backend:
    container_name: lunary-backend
    image: lunary/backend:latest # or specific version (lunary/backend:1.9.8 - full versions list: https://github.com/lunary-ai/lunary/releases)
    ports:
      - "3333:3333"
    restart: unless-stopped
    environment:
      DATABASE_URL: ${DATABASE_URL}
      API_URL: ${API_URL:-http://localhost:3333}
      APP_URL: ${APP_URL:-http://localhost:8080}
      JWT_SECRET: ${JWT_SECRET}
      LICENSE_KEY: ${LICENSE_KEY}
      IS_SELF_HOSTED: "true"
      # Optional environment variables for playground
      OPENAI_API_KEY: ${OPENAI_API_KEY:-}
      AZURE_OPENAI_API_KEY: ${AZURE_OPENAI_API_KEY:-}
      AZURE_OPENAI_RESOURCE_NAME: ${AZURE_OPENAI_RESOURCE_NAME:-}
      AZURE_OPENAI_DEPLOYMENT_ID: ${AZURE_OPENAI_DEPLOYMENT_ID:-}
      ANTHROPIC_API_KEY: ${ANTHROPIC_API_KEY:-}
      OPENROUTER_API_KEY: ${OPENROUTER_API_KEY:-}
      PALM_API_KEY: ${PALM_API_KEY:-}
      # Email configuration
      EMAIL_SENDER_ADDRESS: ${EMAIL_SENDER_ADDRESS:-}
      SMTP_HOST: ${SMTP_HOST:-}
      SMTP_PORT: ${SMTP_PORT:-}
      SMTP_USER: ${SMTP_USER:-}
      SMTP_PASSWORD: ${SMTP_PASSWORD:-}
    networks:
      - lunary-network
    depends_on:
      - ml
      - enrichers
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3333/v1/health"]
      interval: 10s
      start_period: 20s
      timeout: 10s
      retries: 3

  frontend:
    container_name: lunary-frontend
    image: lunary/frontend:latest
    ports:
      - "8080:8080"
    restart: unless-stopped
    environment:
      API_URL: ${API_URL:-http://localhost:3333}
      APP_URL: ${APP_URL:-http://localhost:8080}
    networks:
      - lunary-network
    depends_on:
      - backend
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080"]
      interval: 10s
      start_period: 20s
      timeout: 10s
      retries: 3

  enrichers:
    container_name: lunary-enrichers
    image: lunary/realtime-evaluators:latest
    ports:
      - "3334:3333"
    restart: unless-stopped
    environment:
      DATABASE_URL: ${DATABASE_URL}
      ML_URL: http://ml:4242
    networks:
      - lunary-network
    depends_on:
      - ml

  ml:
    container_name: lunary-ml
    image: lunary/ml:latest
    ports:
      - "4242:4242"
    restart: unless-stopped
    environment:
      DATABASE_URL: ${DATABASE_URL}
    networks:
      - lunary-network
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:4242/health"]
      interval: 20s
      start_period: 80s
      timeout: 10s
      retries: 5

  autoheal:
    restart: always
    image: willfarrell/autoheal
    environment:
      AUTOHEAL_CONTAINER_LABEL: all
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

networks:
  lunary-network:

This configuration includes:

• backend: The Lunary API server
• frontend: The Lunary web interface
• enrichers: Enriches your data by communicating with the ml service
• ml: The machine learning service for advanced features
• autoheal: A service to automatically restart unhealthy containers

Each service is configured with health checks to ensure reliability.

4

Create the environment file

In the same directory, create a .env file with the following variables:

# Required configuration
DATABASE_URL=postgresql://<username>:<password>@<host>:<port>/<dbname>
API_URL=http://localhost:3333
APP_URL=http://localhost:8080
JWT_SECRET=<your_jwt_secret>
LICENSE_KEY=<your_license_key>

# Optional: API keys for AI services (needed for playground)
OPENAI_API_KEY=
ANTHROPIC_API_KEY=
OPENROUTER_API_KEY=
PALM_API_KEY=

# Optional: Azure OpenAI configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_RESOURCE_NAME=
AZURE_OPENAI_DEPLOYMENT_ID=

# Optional: Email configuration (if not provided, no emails will be sent)
EMAIL_SENDER_ADDRESS=
SMTP_HOST=
SMTP_PORT=
SMTP_USER=
SMTP_PASSWORD=

Replace the placeholder values with your actual configuration:

• <username>, <password>, <host>, <port>, <dbname>: Your PostgreSQL database credentials
• <your-backend-ip-or-url>, <your-frontend-ip-or-url>: Your server's IP address or domain name
• <your_jwt_secret>: A secure random string for JWT token generation
• <your_license_key>: Your Lunary Enterprise Edition license key

The other environment variables are optional and enable specific features:

• API keys for various AI services enable the playground
• Email configuration allows Lunary to send invitation emails to organization members

5

Start the services

Run the following command to start all services:

docker compose up -d

This will pull the necessary images and start all services in detached mode. You can check the status of your services with:

docker compose ps

And view logs with:

docker compose logs -f

Or for a specific service:

docker compose logs -f backend

6

🎉 Done!

You're all set! Open http://<your-frontend-ip-or-url>:8080 to access the app.
Make sure to export the environment variable LUNARY_API_URL=http://<your-backend-ip-or-url>:3333 when using the SDK to send queries to your server.