Weaviate

​

어디에 쓰이나요?

• 하이브리드 검색: 벡터 유사도 검색 + 키워드 매칭을 결합하여 검색 품질 향상
• RAG 파이프라인: Dify, LangChain 등에서 벡터 DB 백엔드로 사용
• 멀티테넌시: 하나의 Weaviate에서 여러 프로젝트/사용자의 데이터를 격리하여 관리
• 자동 벡터화: 내장 모듈로 텍스트를 자동으로 벡터로 변환 (별도 임베딩 서버 불필요)

​

Docker Compose

services:
  weaviate:
    image: cr.weaviate.io/semitechnologies/weaviate:latest
    container_name: weaviate
    restart: unless-stopped
    ports:
      - "8080:8080"
      - "50051:50051"
    environment:
      QUERY_DEFAULTS_LIMIT: 25
      AUTHENTICATION_ANONYMOUS_ACCESS_ENABLED: "true"
      PERSISTENCE_DATA_PATH: "/var/lib/weaviate"
      DEFAULT_VECTORIZER_MODULE: "none"
      CLUSTER_HOSTNAME: "node1"
    volumes:
      - weaviate_data:/var/lib/weaviate

volumes:
  weaviate_data:

​

실행

docker compose up -d

​

접속 확인

curl http://localhost:8080/v1/meta

​

기본 정보

​

라이선스

​

참고

• Weaviate Docker 설치 가이드
• Weaviate 공식 문서

​

설치 점검 목록

• docker compose up -d 후 docker compose ps로 컨테이너 상태를 확인했습니다.
• 기본 포트/계정/비밀번호를 문서대로 점검했습니다.
• 운영용으로 사용할 때 기본 비밀번호/시크릿 값을 변경했습니다.
• 장애 분석을 위해 docker compose logs -f 확인 방법을 숙지했습니다.

​

문제 해결 가이드

• 컨테이너가 실행되지 않으면 docker compose logs -f로 오류 원인을 먼저 확인합니다.
• 포트 충돌이 나면 기존 프로세스를 종료하거나 포트 매핑 값을 변경합니다.
• 이미지 pull 실패 시 네트워크 연결 및 레지스트리 접근 권한을 확인합니다.
• 설정 변경 후 문제가 지속되면 docker compose down 후 다시 up -d로 재기동합니다.

​

관련 문서