# 운영: 백업·업그레이드·인증서

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

설치 폴더(`/opt/wisdombase`)에서 명령 한 줄씩이에요.

| 하고 싶은 것 | 명령 |
|---|---|
| 상태 보기 | `docker compose ps` |
| 로그 보기 | `docker compose logs -f wisdombase` (파서 `docparser` · 임베딩 `embedder` · LLM `llm`) |
| 백업 | `sudo ./backup.sh` → `backups/wisdombase-<시각>.tar.gz` (DB 스냅샷 + 첨부 파일 + 설정 · 최근 14개 보관) |
| 복구 | 새 서버에 같은 판을 설치한 뒤 `data/`를 백업의 것으로 바꾸고 `docker compose up -d` |
| 업그레이드 | 새 번들 폴더에서 `sudo ./upgrade.sh /opt/wisdombase` (자동 백업 → 이미지 적재 → 재기동 · 데이터 유지) |
| 판 확인 | `curl -k https://<도메인>/api/onprem/version` |
| 인증서 교체 | `caddy/certs/`의 두 파일 교체 → `docker compose restart caddy` |
| 포트 바꾸기 | `.env`의 `WB_HTTP_PORT`·`WB_HTTPS_PORT` → `docker compose up -d` |

## 자원 조정(.env)

- `WB_PARSER_CONCURRENCY`(기본 4) · `WB_PARSER_MEMORY`(6g) — 큰 PDF·엑셀이 많으면 메모리를 올려요.
- `WB_EMBED_THREADS`(4) — 임베딩 속도. `WB_LLM_THREADS`(8) · `WB_LLM_CTX`(8192) — LLM 팩.
- 값을 바꾼 뒤엔 `docker compose up -d`로 반영돼요.

## 백업은 cron에 걸어 두세요

```
0 3 * * * /opt/wisdombase/backup.sh /opt/wisdombase >> /var/log/wisdombase-backup.log 2>&1
```

새 번들이 나오면 팀 › 온프렘 화면에 나타나요. 업그레이드 전에 백업이 자동으로 한 번 더 돌아요.