logo
icon

LearnHouse

Open-source learning platform — create courses, manage students, and deliver world-class educational content with an all-in-one LMS.

template cover
Deployed1 times
Publisherglasschan
Created2026-06-01
Tags
EducationLMSLearningCourseOpen Source

LearnHouse — Open Source Learning Platform (create by SEAFOODHOLDHAND)

LearnHouse is a next-generation open source learning platform that makes it easy for anyone to provide world-class educational content. This template deploys a complete LearnHouse instance with a single click.

This template includes:

  • LearnHouse App — all-in-one container with Next.js frontend, FastAPI backend, and real-time collaboration server
  • PostgreSQL 16 — database for courses, users, and content
  • Redis — caching and session management

Architecture

[Zeabur LB] → LearnHouse App (:80, internal nginx)
                  ├─ /*           → Next.js Frontend (:8000)
                  ├─ /api/v1/*    → FastAPI Backend (:9000)
                  ├─ /api/auth/*  → NextAuth (via Frontend :8000)
                  ├─ /collab      → Collab WebSocket Server (:4000)
                  └─ /content/*   → Backend Static Content (:9000)

The LearnHouse app image (ghcr.io/learnhouse/app:latest) is an all-in-one container that bundles:

  • Next.js frontend with runtime environment variable injection
  • FastAPI backend for API and content management
  • Collab server for real-time collaboration via WebSocket
  • Internal nginx for routing between frontend, backend, and collab

Features

  • Course Builder — create and organize courses with drag-and-drop
  • Rich Content — support for text, video, embeds, and more
  • Real-time Collaboration — work together with live editing
  • Multi-Organization — support for multiple orgs on one instance
  • Student Management — invite students, track progress
  • AI Features — optional AI-powered features with OpenAI integration
  • Content Storage — filesystem or S3-compatible storage
  • Authentication — email/password + optional Google OAuth

First Login

After deployment completes (may take 2-3 minutes for initial startup):

  1. Open https://your-domain.zeabur.app in your browser
  2. Click Sign In
  3. Log in with the admin email you configured and the auto-generated password
  4. Find your password in Zeabur Dashboard → LearnHouse service → Environment Variables → PASSWORD
  5. Start creating your first course!

Post-Deployment Configuration (Optional)

You can customize these environment variables in the Zeabur Dashboard under the LearnHouse service:

Enable AI features:

  • Set LEARNHOUSE_IS_AI_ENABLED to True
  • Set LEARNHOUSE_OPENAI_API_KEY to your OpenAI API key

Enable Google OAuth:

  • Set LEARNHOUSE_GOOGLE_CLIENT_ID and LEARNHOUSE_GOOGLE_CLIENT_SECRET

Use S3 for content storage:

  • Set LEARNHOUSE_CONTENT_DELIVERY_TYPE to s3api
  • Set LEARNHOUSE_S3_API_BUCKET_NAME and LEARNHOUSE_S3_API_ENDPOINT_URL

Enable email sending:

  • Set LEARNHOUSE_RESEND_API_KEY to your Resend API key

Learn more: https://github.com/learnhouse/learnhouse

If you encounter any issues during deployment, please let me know via GitHub issues: https://github.com/glasschan/seafoodholdhand-zeabur-templates