핵심 요약
- docker compose를 써본 적이 있다면, 일반적인 웹 서비스를 실행하는 정도의 난이도입니다.
- 세 단계: 저장소 클론 → .env 설정 → docker compose up.
- API, 프런트엔드, 데이터베이스, 벡터 인덱스가 모두 로컬에서 실행되어 데이터가 머신을 벗어나지 않습니다.
1단계: Docker를 실행할 수 있는 머신 준비
Docker와 docker compose가 설치된 머신이 필요합니다——평범한 클라우드 서버나 가정용 호스트면 충분합니다. 클라우드 모델 API만 사용한다면 GPU는 필요 없으며, 로컬 모델을 실행하려 할 때에만 그에 맞는 연산 자원이 필요합니다. 먼저 Docker가 정상 작동하는지 확인하세요.
2단계: 저장소 클론 및 .env 설정
GitHub에서 Enclave 저장소를 클론하고, .env 템플릿을 .env로 복사한 뒤, 안내에 따라 필요한 설정(예: 연결하려는 모델 API 키)을 입력합니다. 모든 설정이 이 한 파일에 들어 있으니, 저장소 README와 배포 문서를 따라 입력하면 됩니다.
3단계: 한 줄의 docker compose로 시작
docker compose up을 실행하면 Enclave의 API, 프런트엔드, 데이터베이스, 벡터 인덱스가 함께 로컬에서 올라옵니다. 시작이 끝나면 브라우저로 해당 주소에 접속해, 온전히 당신의 것이며 데이터가 자기 머신에만 저장되는 개인 어시스턴트 세계로 들어갈 수 있습니다. 이후에는 git pull + docker compose up -d만으로 업그레이드할 수 있습니다.
자주 묻는 질문
Enclave를 셀프 호스팅할 수 있나요? 어렵나요?
가능하며, 난이도는 일반적인 web 서비스를 운영하는 것과 비슷합니다. docker compose를 사용해 봤다면 세 단계로 자신의 인스턴스를 가질 수 있습니다: 저장소 클론, .env 복사, docker compose up. API·프런트엔드·데이터베이스·벡터 인덱스가 모두 내 서버에서 실행됩니다.Enclave를 셀프 호스팅하려면 무엇이 필요한가요? GPU가 필요한가요?
반드시 GPU가 필요하지는 않습니다. 클라우드 모델 API(OpenAI, Anthropic 등)를 사용한다면 Docker를 돌릴 수 있는 평범한 서버나 가정용 머신으로 충분합니다 — 추론은 클라우드에서 이루어지고, 본 기기는 앱과 데이터베이스만 실행합니다. 로컬 모델(Ollama / vLLM)로 오프라인 추론을 하려는 경우에만 그에 맞는 VRAM과 연산 능력이 필요합니다.셀프 호스팅한 Enclave를 새 버전으로 업데이트하려면 어떻게 하나요?
git pull로 최신 코드를 받은 뒤 docker compose up -d로 재시작하면 새 버전으로 롤포워드됩니다. CHANGELOG에 각 버전의 호환성 깨짐 변경 사항이 표시되어 있으니, 업그레이드 전에 한 번 훑어보면 됩니다.
한번 써보시겠어요?
브라우저에서 바로 시작하세요. 신용카드 등록도, 설치도 필요 없습니다.