서버에 설치하기

설치는 리눅스 서버 한 대에 Docker로 해요. 10분이면 끝나요.

준비물

항목	요구
서버	리눅스 x86_64 · 8 vCPU · 16GB 메모리 · 디스크 60GB 이상(LLM 팩을 쓰면 +20GB · GPU가 있으면 답변이 빨라요)
소프트웨어	Docker 24 이상, Docker Compose v2 (`docker compose version`으로 확인)
네트워크	인터넷 필요 없음. 사용자 PC에서 서버 443 포트로 접근
도메인	사내 DNS에 등록한 이름 하나(예: `wisdombase.corp.local`). 인증서가 있으면 `fullchain.pem`·`privkey.pem`
라이선스	위 글에서 받은 파일 두 개

1. 번들 풀기

내려받은 파일을 서버로 옮기고 풀어요.

tar -xzf wisdombase-onprem-<판>-amd64.tar.gz
cd wisdombase-onprem-<판>-amd64

폴더 안에는 images.tar(이미지 묶음), install.sh, docker-compose.yml, models/embed.gguf(임베딩 모델), MANUAL.ko.md(안내서)가 들어 있어요.

2. 라이선스 파일 넣기

두 파일을 license/ 폴더에 그대로 복사해요. 이름은 바꾸지 않아도 돼요 — 설치 스크립트가 알아서 자리에 놓아요.

cp ~/다운로드/wisdombase-license.json license/
cp ~/다운로드/corepin-doc-license.json license/

3. 설치 스크립트 실행

sudo ./install.sh --domain wisdombase.corp.local --admin admin@corp.local

--domain 사내에서 접속할 주소, --admin 첫 서버 관리자 이메일이에요. 이 주소로 가입하는 사람이 관리자가 돼요.
80·443 포트를 다른 서비스가 쓰고 있으면 --http-port 8080 --https-port 8443처럼 바꿔요.
앱 컨테이너가 인터넷에 아예 못 나가게 두려면 --airgap을 붙여요(사내 LLM을 외부 주소로 써야 하면 붙이지 말고, 관리 화면의 허용 목록을 쓰세요).
설치 폴더는 /opt/wisdombase예요(--dir로 변경). 설정 .env, 데이터 data/, 라이선스 license/, 모델 models/, 인증서 caddy/certs/가 여기 모여요.

끝나면 이렇게 나와요.

✅ 설치 완료 — https://wisdombase.corp.local
   1) 위 주소로 들어가 .env의 WB_SITE_ADMINS 이메일로 가입하면 서버 관리자가 돼요.
   2) 관리 › 온프렘에서 라이선스·구성 요소 상태를 확인하고 LLM을 연결하세요.

4. 인증서

인증서를 안 넣으면 설치 스크립트가 자체 인증서를 만들어요. 브라우저에 경고가 뜨는 건 정상이에요. 사내 CA 인증서가 있으면 caddy/certs/fullchain.pem·privkey.pem으로 넣고 docker compose restart caddy를 하면 경고가 사라져요.

5. 잘 떴는지 확인

cd /opt/wisdombase && docker compose ps
curl -k https://wisdombase.corp.local/api/onprem/version

wisdombase·wisdombase-docparser·wisdombase-embedder·wisdombase-caddy 네 개가 떠 있고, 두 번째 명령이 "edition":"onprem"과 라이선스 상태를 돌려주면 성공이에요. 문서 파서는 첫 부팅에 1~2분 걸려요.

LLM 팩을 받았다면 sudo ./add-llm-pack.sh <팩 파일> /opt/wisdombase 한 줄로 올라가요 — 「LLM 연결하기」 글에서 이어져요.