DocuBrowse 설치

Linux(RPM, DEB, tarball), Windows(zip), macOS(dmg)용 패키지. GitHub Releases 페이지에서 내려받으세요. 전체 단계별 안내는 INSTALL.md 를 참고하세요.

시스템 요구 사항

	최소	권장
RAM	8 GB	12 GB
CPU	x86_64 또는 ARM64	x86_64 또는 ARM64
GPU	없음(요약이 느려짐)	4 GB 이상 vRAM(NVIDIA 또는 Apple Silicon)
디스크	2 GB 여유 + 문서와 색인	—

32비트 시스템은 지원되지 않습니다(Ollama 가 32비트 빌드를 제공하지 않음). UI 에는 최신 브라우저(Chrome, Firefox, Safari, Edge)를 사용합니다.

설치

Fedora / RHEL

sudo dnf install ./docubrowser-foss-<VERSION>-<RELEASE>.noarch.rpm

Debian / Ubuntu / Mint

sudo apt install ./docubrowser-foss_<VERSION>-<RELEASE>_all.deb

모든 Linux(tarball)

tar xzf docubrowser-foss-<VERSION>-<RELEASE>.tar.gz
cd docubrowser-foss-<VERSION>-<RELEASE>
sudo ./install.sh

모든 Linux 방식은 /opt/docubrowser/ 에 Python 가상 환경과 함께 설치하고, CLI 래퍼를 /usr/bin/docubrowser 와 /usr/bin/docuback 에, 데스크톱 메뉴 항목을 Office 아래에 만듭니다.

Windows

zip 을 풀고 Install.bat 을 더블클릭하세요. Python 3.9 이상과 Ollama 가 미리 설치되어 있어야 합니다. %USERPROFILE%\DocuBrowse 에 설치되고 시작 메뉴 바로가기가 생깁니다. 관리자 권한은 필요 없습니다. 바로가기가 나타나려면 로그아웃 후 다시 로그인해야 할 수 있습니다.

macOS

dmg 를 열고 Install.command 를 더블클릭하세요(스크립트가 서명되지 않았으므로 처음에는 우클릭 → 열기). Python 3.9 이상이 필요합니다. ~/Applications/DocuBrowse/ 에 CLI 래퍼와 DocuBrowse.app 실행기와 함께 설치됩니다.

첫 실행

docubrowser rescan   # 문서를 스캔하고 색인
docubrowser start    # 서버 시작
docubrowser open     # 브라우저에서 UI 열기

start 는 Ollama 가 설치·실행되고 필요한 두 모델(임베딩용 nomic-embed-text:latest 와 요약용 dolphin3:latest)이 있는지 확인한 뒤, 빠진 것을 설치·실행·내려받습니다.

기본적으로 문서 디렉터리는 설정되어 있지 않습니다. 첫 스캔 전에 웹 UI 의 톱니바퀴 아이콘을 클릭하거나 docubrowse.config 에 doc_dir 을 설정하세요.

언어: DocuBrowse 는 영어로 시작합니다. 터미널에서 처음 docubrowser start 할 때 사용할 언어(영어, 일본어, 한국어, 간체 또는 번체 중국어)를 묻습니다. 설정에서 언제든 바꿀 수 있습니다. 언어 를 참고하세요.

사전 준비

패키지 설치는 requirements.txt 에서 Python 의존성을 가져옵니다. 클론한 저장소라면 Python 3.9 이상과 다음이 필요합니다:

pdfplumber, pypdf: PDF 추출
python-docx, python-pptx, openpyxl: Office 파일
ebooklib, beautifulsoup4, mobi: 전자책
striprtf: RTF(없으면 .rtf 는 메타데이터만 색인)
psutil: 하드웨어 감지
Calibre: MOBI/AZW3/AZW 에 필수(sudo dnf install calibre 또는 sudo apt install calibre)
libvisio-tools(선택): 구형 바이너리 Visio 파일의 본문 텍스트
DjVuLibre(선택): DjVu 파일의 텍스트
Ollama: 없으면 docubrowser start 가 자동 설치

제거

sudo dnf remove docubrowser-foss       # RPM
sudo apt remove docubrowser-foss       # DEB
sudo ./uninstall.sh                    # tarball

Windows: Uninstall.bat 더블클릭. macOS: Uninstall.command 더블클릭.

문제 해결

Ollama 가 시작되지 않음

ollama serve
ollama list
ollama pull nomic-embed-text:latest
ollama pull dolphin3:latest

스캔 진행이 멈춘 것처럼 보임

tail -f /var/log/docubrowser.log
# 또는
tail -f ~/.local/share/docubrowser/docubrowser.log

inotify 감시 한도

대규모 컬렉션에서는 inotify watch limit reached 가 로그에 보일 수 있습니다. 무시해도 안전합니다. 없애려면 /etc/sysctl.conf 에서 fs.inotify.max_user_instances 를 256 이나 512 로 올린 뒤 sudo sysctl -p 를 실행하세요.

스캔된(이미지 전용) PDF

자리표시자로 색인되고 ocr_list_pdfs.txt 에 기록되지만, OCR 을 실행하기 전까지는 검색에 걸리지 않습니다.