Skip to Content
Edit on GitHub

Configuration Overview

LearnHouse uses environment variables as its primary configuration method. When you run learnhouse setup, the CLI generates a .env file with all the necessary variables based on your choices.

Configuration Methods

LearnHouse supports two configuration methods:

  1. Environment variables (via .env file) — the primary and recommended method
  2. Configuration file (config.yaml) — an alternative for advanced users

If both are present, environment variables always take precedence over values defined in config.yaml.

Editing Configuration

You can modify your configuration at any time using the CLI:

learnhouse config --edit

Alternatively, edit the .env file directly and restart services:

learnhouse restart

Configuration Sections

  • Environment Variables — Complete reference of all available environment variables.
  • AI Setup — Enable and configure AI-powered features.
  • Email — Set up email delivery for invitations, password resets, and notifications.
  • Content Storage — Configure filesystem or S3-compatible storage for uploaded content.
  • SSL and Domain — Set up your domain name and SSL certificates.