LearnHouse
시작하기
LearnHouse
AI엔터프라이즈개발자모바일요금제
GitHub...
로그인시작하기

새로운 세대를 위한 모던 오픈소스 학습 플랫폼

XGitHubLinkedInDiscord

제품

  • 크리에이터
  • 교육기관
  • 엔터프라이즈
  • 개발자
  • 모바일 앱
  • 오픈소스
  • 디자인
  • 검색 노출
  • 요금제

기능

  • 강좌
  • AI
  • 결제
  • 커뮤니티
  • 팟캐스트
  • 보드
  • Plays
  • 코드
  • 분석
  • 동영상 강좌
  • 뉴스레터
  • 라이브 세션
  • 학습 경로
  • 순차 공개
  • 과제
  • 수료증
  • 시나리오
  • 필수 교육
  • 강좌 번역
  • 연동

리소스

  • 문서
  • 유니버시티
  • 블로그
  • 업데이트 내역
  • 셀프 호스팅
  • 용어집
  • GitHub
  • 플랫폼 비교

회사

  • 문의
  • 보안
  • 산업별

회사

  • 문의
  • 보안
  • 산업별

LearnHouse 비교

  • Udemy
  • Moodle
  • Teachable
  • Open edX
  • Thinkific
  • Canvas
  • Kajabi
  • Skool
  • Podia
  • Coursera
  • 전체 비교

대안

  • Udemy
  • Teachable
  • Thinkific
  • Kajabi
  • Skool
  • Podia
  • Coursera
  • Moodle
  • Open edX
  • Canvas LMS
  • Skillshare
  • Mighty Networks
  • LearnWorlds
  • Circle
버그나 문제를 발견하셨나요?
Open Source Initiative

오픈소스

AGPLv3 라이선스, 셀프호스팅 가능

GDPR 대응

EU 데이터 보호 규정 준수

G2

G2

G2에서 리뷰 남기기

© 2026 LearnHouse, Inc.

  • 개인정보처리방침
  • 이용약관
  • 쿠키 정책
  1. LearnHouse
  2. /
  3. 셀프호스팅
  4. /
  5. Docker

Docker로 서버 한 대에서 실행하는 LearnHouse

LearnHouse를 셀프호스팅하는 가장 빠른 방법은 Docker가 설치된 서버 한 대예요. npx learnhouse@latest setup을 실행하고 몇 가지 질문에 답한 다음, npx learnhouse start를 실행하세요. CLI가 Docker Compose 파일을 작성하고 관리하므로 직접 수정할 필요가 없어요.

$ npx learnhouse@latest setup

마법사가 묻는 것

  • ?도메인, 또는 시험해 보려면 localhost
  • ?PostgreSQL과 Redis: 로컬 컨테이너 또는 외부 연결 문자열
  • ?첫 관리자의 이메일과 비밀번호
  • ?선택 항목: AI 기능과 이메일 발송

$ npx learnhouse start

$ npx learnhouse doctor

설치 전 과정

$npx learnhouse@latest setup
$npx learnhouse start

대부분의 질문에는 Enter로 수락할 수 있는 기본값이 있어요. 처음 시작할 때는 이미지를 내려받느라 1~2분 정도 걸려요.

작성되는 파일

learnhouse/

  • docker-compose.yml

    모든 서비스와 볼륨.

  • .env

    설정과 생성된 시크릿.

  • learnhouse.config.json

    설치 설정.

  • nginx / Caddy

    리버스 프록시용 nginx 또는 Caddy 설정.

서버 사양

최소권장
메모리2 GB4 GB
CPU12+
디스크10 GB20 GB+

프로덕션에는 Linux를 권장해요: Ubuntu 20.04+, Debian 11+, CentOS 8+ 또는 Docker가 돌아가는 모든 배포판. macOS는 Docker Desktop으로, Windows는 WSL2로 실행할 수 있어요.

80, 443 포트가 열려 있어야 하고, 설치 중 이미지를 내려받기 위해 인터넷에 연결돼 있어야 해요.

일상 운영

npx learnhouse start
모든 서비스를 시작해요.
npx learnhouse stop
모든 서비스를 중지해요.
npx learnhouse logs
컨테이너 로그를 실시간으로 봐요.
npx learnhouse config
현재 설정을 보여줘요.
npx learnhouse backup
데이터베이스를 백업하거나 복원해요.
npx learnhouse doctor
Docker, 컨테이너, 포트, DNS, 디스크 공간을 점검해요.
npx learnhouse update
최신 릴리스를 가져와요.

learnhouse backup은 데이터베이스의 pg_dump와 .env 사본을 타임스탬프가 붙은 아카이브로 저장해요. 업로드된 파일은 포함되지 않으므로 콘텐츠 볼륨도 따로 백업하거나, 업로드를 S3 호환 스토리지에 보관하세요.

서버 한 대로 충분한 경우

대부분의 학교, 교육 팀, 강좌 비즈니스에는 서버 한 대면 충분해요. 웹 앱과 API를 여러 개 복제해 실행해야 하거나, 회사가 이미 모든 것을 클러스터에서 운영하고 있다면 Kubernetes로 옮기세요.

자주 묻는 질문

데이터베이스를 관리형 서비스에서 실행할 수 있나요?+

네. PostgreSQL 연결 문자열과 함께 --external-db를, Redis에는 --external-redis를 넘기거나, 마법사에서 External을 선택하세요.

업로드 파일은 어디에 저장되나요?+

기본값은 Docker 볼륨이에요. .env 파일의 설정 세 개만 바꾸면 AWS S3, Cloudflare R2, MinIO 같은 S3 호환 서비스로 전환할 수 있어요.

HTTPS는 어떻게 추가하나요?+

.env 파일에 도메인과 LEARNHOUSE_SSL=true를 설정한 다음, 앞단에 리버스 프록시를 두세요. Caddy는 Let's Encrypt 인증서를 알아서 발급받고 갱신해요.

셀프호스팅 가이드

실행 환경

  • Docker
  • Kubernetes
  • AWS
  • Google Cloud
  • Azure
  • 온프레미스

규정과 데이터

  • 데이터 레지던시
  • GDPR
  • 의료, 교육, 공공
셀프호스팅 문서 Enterprise에서 추가되는 기능

서버를 직접 운영하고 싶지 않나요? LearnHouse Cloud가 같은 플랫폼을 대신 운영하고, 업데이트, 백업, TLS까지 처리해 드려요.

Cloud 요금제 보기