# 서버에 설치하기

> Source: https://wisdombase.ai/@help/onprem/install · Last updated: 2026-09-10

설치는 **리눅스 서버 한 대**에 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. 번들 풀기

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

```bash
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/` 폴더에 그대로 복사해요. 이름은 바꾸지 않아도 돼요 — 설치 스크립트가 알아서 자리에 놓아요.

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

## 3. 설치 스크립트 실행

```bash
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. 잘 떴는지 확인

```bash
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 연결하기」 글에서 이어져요.