DocuMindKorea

Installation Guide

설치 가이드

Docker Compose 기반 온프레미스 설치형. 고객사 서버에 5~10분이면 구축됩니다. Linux·Windows 둘 다 지원합니다.

1

최소 시스템 요구사항

공통

최소 사양

CPU4코어
RAM8 GB
디스크100 GB SSD

권장 사양

CPU8코어
RAM32 GB
디스크500 GB SSD
2

라이선스·패키지 준비

공통

가입·결제 후 라이선스 키를 발급받고, 설치 패키지에서 OS에 맞는 번들을 다운로드합니다.

🔒
폐쇄망 환경이라면 "폐쇄망 번들"을 사용하세요. 모든 도커 이미지·AI 모델이 포함되어 외부 인터넷 없이도 설치 가능합니다.
3

OS 선택

여기서부터 분기됩니다

4

Linux 설치

🐧 Ubuntu 22.04 / RHEL 8+ / Rocky Linux

⚡

방법 A — curl 한 줄 설치 (권장)

curl

인터넷 연결만 있으면 명령어 한 줄로 끝. Docker가 없으면 자동 설치, 패키지 다운로드·환경변수 설정·systemd 등록·실행까지 한 번에 처리합니다.

terminal
# 라이선스 키만 있으면 끝 (root 권한)
curl -L https://get.documindkorea.com | sudo bash -s -- \
  --license=DM-xxxxxxxxxxxxxxxx \
  --domain=documind.company.com

스크립트가 자동으로 처리:

  • ✓ Docker Engine + Compose 설치 (없는 경우)
  • ✓ /opt/documind에 패키지 압축 해제
  • ✓ .env 자동 생성 (라이선스·DB 비밀번호 포함)
  • ✓ Docker 이미지 14개 자동 다운로드
  • ✓ systemd 서비스 등록 (부팅 시 자동 시작)
  • ✓ 방화벽 규칙 자동 추가
  • ✓ 헬스체크 대기 후 완료

⏱ 5~10분 후 http://[서버IP]/ 접속 가능

📦

방법 B — 설치 패키지 다운로드

.tar.gz

구독자 포털에서 Docker·이미지·AI 모델까지 전부 포함된 단일 .tar.gz 파일을 받아 설치. 폐쇄망·인터넷 제한 환경에서도 USB로 옮겨 설치 가능합니다.

terminal
# 1. 다운로드한 번들 (≈ 5GB)
ls
# documind-package-v1.0.0-linux.tar.gz

# 2. 압축 해제
tar xzf documind-package-v1.0.0-linux.tar.gz
cd documind-package

# 3. 설치 (자동 진행)
sudo ./install.sh --license=DM-xxxxxxxxxxxxxxxx

패키지에 포함되는 것:

  • 📦 Docker Engine .deb / .rpm 파일
  • 🐋 Docker Compose 바이너리
  • 💿 14개 컨테이너 이미지 (.tar 파일)
  • 🤖 임베딩·재랭킹 AI 모델 (Mode B용)
  • 📜 install.sh / docker-compose.yml / .env.template
📥
설치 패키지는 구독자 포털에서 다운로드 가능합니다.
방법 C — 수동 설치 (고급)

자동 스크립트 사용 안 하고 단계별로 직접 진행

▼
C-1

Docker 직접 설치

terminal
# Ubuntu·Debian 계열
curl -fsSL https://get.docker.com | sudo sh
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

# RHEL·CentOS·Rocky 계열
sudo dnf install -y docker docker-compose-plugin
sudo systemctl enable --now docker
C-2

패키지 압축 해제 + .env 편집

terminal
sudo mkdir -p /opt/documind && cd /opt/documind
tar xzf ~/Downloads/documind-linux-*.tar.gz
cp .env.example .env
nano .env
C-3

실행 + systemd 등록

terminal
# 컨테이너 시작
docker compose up -d

# systemd 서비스 등록 (부팅 시 자동 시작)
sudo cp scripts/documind.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now documind
5

Linux 트러블슈팅

⚠Permission denied — docker.sock 접근 불가▼

sudo usermod -aG docker $USER 후 로그아웃·로그인.

⚠포트 80·443이 이미 사용 중▼

sudo lsof -i :80 으로 사용 중인 프로세스 확인. nginx·apache 등 기존 웹서버가 있다면 중지하거나 docker-compose.yml에서 포트 변경.

⚠container healthcheck 실패▼

docker compose logs <서비스명> 으로 상세 확인. 메모리 부족이 가장 흔함 — RAM 8GB 미만이면 업그레이드 권장.

6

Linux 삭제 · 제거

⚠️
삭제 전 확인 — 모든 사내 문서·DB·로그가 함께 사라집니다. 필요한 자료는 반드시 두 가지 모두 백업하세요:
  • PostgreSQL DB — 사용자·권한·메타데이터·채팅 기록
  • MinIO 객체 스토리지 — 업로드한 원본 문서 파일
💾

삭제 전 전체 백업 (필수)

아래 한 줄로 DB + 업로드 문서 + 설정을 모두 백업합니다.

삭제 전 백업
# 백업 폴더 생성
BACKUP_DIR="$HOME/documind-final-backup-$(date +%Y%m%d)"
mkdir -p "$BACKUP_DIR"

# 1. PostgreSQL DB 백업 (메타데이터)
docker exec documind-postgres pg_dump -U documind_super documind \
  | gzip > "$BACKUP_DIR/db.sql.gz"

# 2. MinIO 업로드 문서 백업 (원본 파일들) — 가장 중요!
docker run --rm \
  -v documind_minio_data:/data:ro \
  -v "$BACKUP_DIR":/backup \
  alpine tar czf /backup/uploaded-documents.tar.gz -C /data .

# 3. 설정·환경변수 백업
cp /opt/documind/.env "$BACKUP_DIR/env.backup"
cp /opt/documind/docker-compose.yml "$BACKUP_DIR/"

# 4. 백업 검증
ls -lh "$BACKUP_DIR"
echo "✅ 백업 완료: $BACKUP_DIR"
echo "👉 이 폴더를 USB·NAS·외부 디스크에 복사하세요"
📦
백업 파일 크기 예시
  • db.sql.gz — 1~10GB (메타데이터·인덱스)
  • uploaded-documents.tar.gz — 회사 규모별 10GB ~ 1TB (가장 큼)
  • env.backup — 1KB 이하
전체 사이즈가 클 수 있으니 백업 디스크 여유 공간을 미리 확인하세요.
🔄
나중에 재설치할 거라면 — 백업본을 외부에 안전하게 보관하세요. 관리자 매뉴얼 백업·복구 섹션에서 복구 절차 확인 가능.
6-1

컨테이너 중지 (데이터 보존)

나중에 다시 사용할 수 있도록 데이터는 그대로 두고 멈추기.

terminal
cd /opt/documind
sudo systemctl stop documind
sudo systemctl disable documind
sudo docker compose down
6-2

완전 삭제 (데이터 포함)

모든 컨테이너·볼륨·서비스 등록·설치 디렉토리 영구 제거.

terminal
# 컨테이너·볼륨까지 삭제
cd /opt/documind
sudo docker compose down -v

# systemd 서비스 제거
sudo rm /etc/systemd/system/documind.service
sudo systemctl daemon-reload

# 설치 디렉토리 삭제
sudo rm -rf /opt/documind

# 백업 파일도 정리할 거면 (신중!)
# sudo rm -rf /backup/documind
6-3

Docker 자체 제거 (선택)

다른 도커 컨테이너도 안 쓴다면 Docker Engine 자체도 제거 가능.

terminal
# Docker 중지
sudo systemctl stop docker

# Ubuntu·Debian 계열
sudo apt remove -y docker-ce docker-ce-cli containerd.io

# RHEL·CentOS·Rocky 계열
sudo dnf remove -y docker docker-compose-plugin

# Docker 데이터까지 (모든 컨테이너 데이터 사라짐!)
sudo rm -rf /var/lib/docker /var/lib/containerd

일시 중지 (데이터 보존)

컨테이너만 중지 — 재실행 시 데이터 그대로 복원

완전 삭제 (복구 불가)

볼륨·디렉토리까지 영구 제거 — 사전 백업 필수

🔑
라이선스 키 회수 — 같은 라이선스로 다른 서버에 재설치하려면 우리 서버에서 해제 처리가 필요합니다. 문의 폼으로 요청해주세요.
7

접속 확인

공통

👥

직원 사용자

http://[서버IP]/

문서 업로드·AI 질문·검색

🛡

고객사 관리자

http://[서버IP]/admin

사용자·부서·권한·감사 로그

🌐
도메인 연결 시 — DNS 설정 후 http://documind.회사도메인.com/ 식으로 접속 가능합니다. .env의 DOMAIN 값에 도메인을 지정하세요.
8

다음 단계

⚙

관리자 매뉴얼→

첫 사용자 초대 · 부서·권한 설정

👤

사용자 설명서→

직원들에게 배포할 사용 가이드

🚨

설치 중 오류가 발생했나요?

로그(Linux: docker compose logs, Windows: 이벤트 뷰어 또는 같은 명령) 를 첨부해서 문의 폼에 보내주세요. 영업일 1~2일 내 기술팀이 직접 답변 드립니다.

기술 문의하기 →