LearnHouse를 셀프호스팅하는 가장 빠른 방법은 Docker가 설치된 서버 한 대예요. npx learnhouse@latest setup을 실행하고 몇 가지 질문에 답한 다음, npx learnhouse start를 실행하세요. CLI가 Docker Compose 파일을 작성하고 관리하므로 직접 수정할 필요가 없어요.
$ npx learnhouse@latest setup
마법사가 묻는 것
$ npx learnhouse start
$ npx learnhouse doctor
npx learnhouse@latest setupnpx learnhouse start대부분의 질문에는 Enter로 수락할 수 있는 기본값이 있어요. 처음 시작할 때는 이미지를 내려받느라 1~2분 정도 걸려요.
작성되는 파일
learnhouse/
docker-compose.yml
모든 서비스와 볼륨.
.env
설정과 생성된 시크릿.
learnhouse.config.json
설치 설정.
nginx / Caddy
리버스 프록시용 nginx 또는 Caddy 설정.
| 최소 | 권장 | |
|---|---|---|
| 메모리 | 2 GB | 4 GB |
| CPU | 1 | 2+ |
| 디스크 | 10 GB | 20 GB+ |
프로덕션에는 Linux를 권장해요: Ubuntu 20.04+, Debian 11+, CentOS 8+ 또는 Docker가 돌아가는 모든 배포판. macOS는 Docker Desktop으로, Windows는 WSL2로 실행할 수 있어요.
80, 443 포트가 열려 있어야 하고, 설치 중 이미지를 내려받기 위해 인터넷에 연결돼 있어야 해요.
learnhouse backup은 데이터베이스의 pg_dump와 .env 사본을 타임스탬프가 붙은 아카이브로 저장해요. 업로드된 파일은 포함되지 않으므로 콘텐츠 볼륨도 따로 백업하거나, 업로드를 S3 호환 스토리지에 보관하세요.
서버 한 대로 충분한 경우
대부분의 학교, 교육 팀, 강좌 비즈니스에는 서버 한 대면 충분해요. 웹 앱과 API를 여러 개 복제해 실행해야 하거나, 회사가 이미 모든 것을 클러스터에서 운영하고 있다면 Kubernetes로 옮기세요.
네. PostgreSQL 연결 문자열과 함께 --external-db를, Redis에는 --external-redis를 넘기거나, 마법사에서 External을 선택하세요.
기본값은 Docker 볼륨이에요. .env 파일의 설정 세 개만 바꾸면 AWS S3, Cloudflare R2, MinIO 같은 S3 호환 서비스로 전환할 수 있어요.
.env 파일에 도메인과 LEARNHOUSE_SSL=true를 설정한 다음, 앞단에 리버스 프록시를 두세요. Caddy는 Let's Encrypt 인증서를 알아서 발급받고 갱신해요.
서버를 직접 운영하고 싶지 않나요? LearnHouse Cloud가 같은 플랫폼을 대신 운영하고, 업데이트, 백업, TLS까지 처리해 드려요.
Cloud 요금제 보기