Self-Hosting ZəkaHouse

ZəkaHouse can be self-hosted on your own infrastructure using the ZəkaHouse CLI. The CLI handles everything from initial setup to ongoing maintenance, including Docker Compose generation, environment file management, service orchestration, backups, and health checks.

Quick Start

Make sure you have Docker Engine 20.10+, Docker Compose 2.0+, Node.js 18+, and Bun installed, and access to the ZəkaHouse repository. Then build the CLI, build the app image from the repository root, and run the setup wizard:

docker build -t zeka-learnhouse:local .
zeka-learnhouse setup --image zeka-learnhouse:local

The interactive setup wizard will walk you through domain configuration, database settings, admin credentials, and optional features, then start all services. ZəkaHouse will be available at http://localhost  (or your configured domain). Log in with the admin credentials you provided during setup.

See Quick Install for the full step-by-step walkthrough.

Verify the installation

zeka-learnhouse doctor

Common management commands

zeka-learnhouse stop       # Stop all services
zeka-learnhouse start      # Start all services
zeka-learnhouse logs       # Stream container logs
zeka-learnhouse config     # View current configuration
zeka-learnhouse backup     # Backup or restore the database
zeka-learnhouse doctor     # Diagnose issues

Documentation

Installation

System requirements, quick install steps, and the full CLI command reference.

Configuration

Environment variables, AI features, email delivery, content storage, and SSL/domain setup.

Maintenance

Updates, backups, monitoring, and troubleshooting guides.