# 문제가 생겼어요

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

## 설치·기동

- **`docker compose ps`에 `wisdombase-docparser`가 unhealthy** — 첫 부팅 1~2분은 정상이에요. 계속되면 `docker compose logs docparser`에서 `license` 줄을 확인하세요. `license/license.json`이 없거나 다른 파일이면 파서가 부팅하지 않아요.
- **`wisdombase-embedder`가 unhealthy** — 모델(`models/embed.gguf`, 약 640MB)을 읽는 중이에요. 느린 디스크에선 2분 넘게 걸릴 수 있어요. 그 사이 올린 문서는 30분 안에 자동으로 다시 임베딩돼요.
- **브라우저에 「연결이 비공개가 아닙니다」** — 자체 인증서라 그래요. 사내 CA 인증서를 `caddy/certs/`에 넣으면 사라져요.
- **80/443 포트 충돌** — `.env`의 `WB_HTTP_PORT`·`WB_HTTPS_PORT`를 바꾸고 `docker compose up -d`.

## 가져오기·검색

- **「사내 웹이 아닌 주소예요」** — URL 가져오기는 사설망과 허용 목록 호스트만 돼요. 관리 › 온프렘 › 「URL 가져오기를 허용할 사내 웹 호스트」에 추가하세요.
- **스캔 PDF가 「글자가 없어요」** — 온프렘 판은 OCR이 없어요. 글자가 든 PDF로 다시 저장해 올려 주세요.
- **문서는 들어왔는데 검색이 안 돼요** — 관리 › 온프렘 › 구성 요소에서 임베딩 서버가 「연결됨」인지 보세요. 임베딩은 부팅 직후 도움말 문서부터 순서대로 처리하니 몇 분 기다려 주세요.
- **챗봇이 문장 대신 발췌만 줘요** — LLM이 연결돼 있지 않거나 응답이 4분을 넘겼어요. 관리 › 온프렘 › LLM 연결에서 「연결 시험」을 눌러 보세요. CPU만 있으면 경량 팩을 쓰거나 답변 대기 시간을 `.env`의 `WB_LLM_TIMEOUT_MS`로 늘릴 수 있어요.

## 외부 통신

- **「최근 차단된 외부 통신」에 호스트가 쌓여요** — 설계대로 막힌 거예요. 필요한 호스트면 허용 목록에 넣고, 아니면 무시하면 돼요.
- **사내 LLM 주소가 공인 도메인이라 연결 시험은 되는데 답변이 안 돼요** — 저장하면 LLM 주소는 자동 허용되지만, 리다이렉트되는 다른 호스트가 있으면 그 호스트도 허용 목록에 적어 주세요.

## 그래도 안 풀리면

`docker compose logs --tail 200 wisdombase` 결과와 관리 › 온프렘 화면 캡처를 **support@wisdombase.ai**로 보내 주세요. 라이선스 ID(`WB-…`)를 같이 적어 주시면 빨라요.