Quickstart

There are two ways to start using ZəkaHouse: the managed ZəkaHouse Cloud or a self-hosted deployment. Pick the path that suits your needs.

Option A — ZəkaHouse Cloud

The fastest way to get started. No infrastructure to manage.

Note: ZəkaHouse Cloud is ZekaLab’s managed offering — there isn’t a public self-serve signup flow to link to yet. Reach out via zekalab.info  to get an organization provisioned.

1. Sign up — Contact ZekaLab via zekalab.info  to get a managed organization set up.
2. Create an organization — Once your account is ready, create your first organization. This is the top-level container for all of your courses, users, and settings.
3. Create your first course — Inside the organization dashboard, click New Course, give it a title, and start adding chapters and activities.

You are ready to go. ZəkaHouse Cloud handles hosting, updates, backups, and SSL for you.

Option B — Self-Hosted

Run ZəkaHouse on your own infrastructure using the ZəkaHouse CLI. You’ll need access to the ZəkaHouse repository, plus Docker , Node.js  (v18+), and Bun .

1. Install the CLI and build the app image

Build the CLI from the repository and put zeka-learnhouse on your PATH (CLI → Installation), then build the app image from the repository root:

docker build -t zeka-learnhouse:local .

2. Run the setup wizard

zeka-learnhouse setup --image zeka-learnhouse:local

The interactive wizard walks you through domain configuration, database setup, admin account creation, and optional features (AI, email, storage, OAuth), then starts ZəkaHouse. Your instance will be available at http://localhost (or the domain you configured during setup).

3. Manage your instance

zeka-learnhouse stop     # Stop all services
zeka-learnhouse logs     # Stream logs
zeka-learnhouse backup   # Backup database
zeka-learnhouse doctor   # Run diagnostics

What to do next

• Familiarize yourself with the Key Concepts — organizations, courses, activities, and more.
• Explore the Editor to see how content authoring works.
• Set up AI features if you want built-in AI assistance for students and teachers.