Skip to main content

Installation

Set up Lumio using Docker Compose.

Prerequisites​

  • Docker and Docker Compose
  • A PostgreSQL 18 instance (or use the provided compose file)
  • Redis 8

Docker Setup​

# Start the dev stack (PostgreSQL, TimescaleDB, Redis)
docker compose -f dev-stack/db.docker-compose.yml up -d

# Start the web app
docker compose -f dev-stack/web.docker-compose.yml up -d

Environment Configuration​

Copy .env.example to .env and configure:

cp .env.example .env

Key variables:

VariableDescription
DATABASE_URLPostgreSQL connection string
REDIS_URLRedis connection string
AUTH_SECRETNextAuth session secret (ID app)
AUTH_URLID app base URL

Verify Installation​

Visit http://localhost:4000 to access the Lumio dashboard.