> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baeum.ai.kr/llms.txt
> Use this file to discover all available pages before exploring further.

# Weaviate

**벡터 + 키워드 하이브리드 검색**을 지원하는 벡터 데이터베이스입니다. 벡터 검색과 BM25 키워드 검색을 결합하여 더 정확한 검색 결과를 제공합니다.

## 어디에 쓰이나요?

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

## Docker Compose

```yaml docker-compose.yml theme={null}
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:
```

## 실행

```bash theme={null}
docker compose up -d
```

## 접속 확인

```bash theme={null}
curl http://localhost:8080/v1/meta
```

## 기본 정보

| 항목          | 값     |
| ----------- | ----- |
| REST API 포트 | 8080  |
| gRPC 포트     | 50051 |

## 라이선스

| 구분     | 내용                       |
| ------ | ------------------------ |
| 라이선스   | BSD 3-Clause             |
| 개인 사용  | 자유롭게 사용 가능               |
| 상업적 사용 | 자유롭게 사용 가능, 수정/재배포 제한 없음 |

## 참고

* [Weaviate Docker 설치 가이드](https://weaviate.io/developers/weaviate/installation/docker-compose)
* [Weaviate 공식 문서](https://weaviate.io/developers/weaviate)

## 설치 점검 목록

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

## 문제 해결 가이드

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

## 관련 문서

<CardGroup cols={2}>
  <Card title="Setup 홈" icon="house" href="/setup/index">
    운영체제별 설치 흐름을 다시 확인합니다.
  </Card>

  <Card title="다음: ChromaDB" icon="arrow-right" href="/stacks/chromadb">
    다음 설치 단계를 이어서 진행합니다.
  </Card>
</CardGroup>