A forma mais rápida de auto-hospedar o LearnHouse é um único servidor com Docker. Rode npx learnhouse@latest setup, responda a algumas perguntas e depois rode npx learnhouse start. A CLI gera e gerencia os arquivos do Docker Compose, então você nunca precisa editá-los manualmente.
$ npx learnhouse@latest setup
O que o assistente pergunta
$ npx learnhouse start
$ npx learnhouse doctor
npx learnhouse@latest setupnpx learnhouse startA maioria das perguntas tem um valor padrão que você aceita com Enter. A primeira inicialização baixa as imagens e leva um ou dois minutos.
O que ele gera
learnhouse/
docker-compose.yml
Todos os serviços e seus volumes.
.env
Configurações e segredos gerados.
learnhouse.config.json
As configurações da sua instalação.
nginx / Caddy
Uma configuração de nginx ou Caddy para o proxy reverso.
| Mínimo | Recomendado | |
|---|---|---|
| Memória | 2 GB | 4 GB |
| CPU | 1 | 2+ |
| Disco | 10 GB | 20 GB+ |
Linux é o recomendado para produção: Ubuntu 20.04+, Debian 11+, CentOS 8+ ou qualquer distribuição com Docker. O macOS funciona com o Docker Desktop, e o Windows pelo WSL2.
Portas 80 e 443 abertas e acesso à internet durante a instalação para baixar as imagens.
learnhouse backup grava um pg_dump do banco de dados e uma cópia do seu .env em um arquivo compactado com data e hora. Os arquivos enviados não entram nele, então faça backup também do volume de conteúdo, ou mantenha os uploads em um armazenamento compatível com S3.
Quando um servidor basta
Um único servidor atende à maioria das escolas, equipes de treinamento e negócios de cursos. Passe para o Kubernetes quando precisar de várias cópias da aplicação web e da API, ou quando a sua empresa já roda tudo em clusters.
Sim. Passe --external-db com uma string de conexão do PostgreSQL e --external-redis para o Redis, ou escolha External no assistente.
Por padrão, para um volume Docker. Você pode trocar para qualquer serviço compatível com S3, como AWS S3, Cloudflare R2 ou MinIO, com três configurações no arquivo .env.
Defina o seu domínio e LEARNHOUSE_SSL=true no arquivo .env e coloque um proxy reverso na frente. O Caddy obtém e renova sozinho os certificados do Let's Encrypt.
Prefere não cuidar de servidores? O LearnHouse Cloud roda a mesma plataforma para você, com atualizações, backups e TLS já resolvidos.
Ver planos do Cloud