The quickest way to self-host LearnHouse is a single server with Docker. Run npx learnhouse@latest setup, answer a few questions, then run npx learnhouse start. The CLI writes and manages the Docker Compose files, so you never have to edit them yourself.
$ npx learnhouse@latest setup
What the wizard asks
$ npx learnhouse start
$ npx learnhouse doctor
npx learnhouse@latest setupnpx learnhouse startMost questions have a default you can accept with Enter. The first start pulls the images and takes a minute or two.
What it writes
learnhouse/
docker-compose.yml
Every service and its volumes.
.env
Settings and generated secrets.
learnhouse.config.json
Your install settings.
nginx / Caddy
An nginx or Caddy config for the reverse proxy.
| Minimum | Recommended | |
|---|---|---|
| Memory | 2 GB | 4 GB |
| CPU | 1 | 2+ |
| Disk | 10 GB | 20 GB+ |
Linux is recommended for production: Ubuntu 20.04+, Debian 11+, CentOS 8+ or any distribution with Docker. macOS works with Docker Desktop, Windows through WSL2.
Ports 80 and 443 open, and internet access during install to pull the images.
learnhouse backup writes a pg_dump of the database and a copy of your .env into a timestamped archive. Uploaded files are not part of it, so back up the content volume as well, or keep uploads in S3-compatible storage.
When one server is enough
A single server suits most schools, training teams and course businesses. Move to Kubernetes when you need several copies of the web app and API, or when your company runs everything on clusters already.
Yes. Pass --external-db with a PostgreSQL connection string and --external-redis for Redis, or pick External in the wizard.
A Docker volume by default. You can switch to any S3-compatible service, such as AWS S3, Cloudflare R2 or MinIO, with three settings in the .env file.
Set your domain and LEARNHOUSE_SSL=true in the .env file, then put a reverse proxy in front. Caddy fetches and renews Let's Encrypt certificates on its own.
Would you rather not run servers? LearnHouse Cloud runs the same platform for you, with updates, backups and TLS handled.
See Cloud plans