Windows에 Qdrant 설치하기

안녕하세요 이번 시간에는 벡터 DB로 많이 사용되는 Qdrant를 Windows 에 설치하는 방법에 대해 알아보도록 하겠습니다.

기본적으로 Qdrant 설치는 docker나 k8s에서 진행하는게 정식 루트이기 때문에, 해당 가이드를 통해서 다운받는 Qdrant는 테스트 용으로만 활용하시기 바랍니다.

 

1. Qdrant 바이너리 다운로드 (WSL)

우선 윈도우에서 Qdrant를 설치하기 위해서는 WSL이 필요합니다.

WSL 설치하는 방법에 대해 모르시는 분들은 2026.04.10 - [IT/Linux] - 윈도우(Windows)에서 WSL(Windows Subsystem for Linux) 설치하기 를 참고하시기 바랍니다.

WSL이 설치가 완료되셨으면 WSL(우분투) 실행 후 아래 명령어를 통해 Qdrant 바이너리를 다운받습니다.

sudo apt update
cd ~
mkdir qdrant
cd qdrant
curl -L https://github.com/qdrant/qdrant/releases/latest/download/qdrant-x86_64-unknown-linux-gnu.tar.gz -o qdrant.tar.gz
tar -xzf qdrant.tar.gz

 

---

2. 웹 대시보드 정적 파일 다운로드 

Qdrant는 DB를 관리할 수 있는 대시보드를 지원합니다. 대시보드는 아래와 같이 별도로 설치 후 압축을 풀어주면 됩니다.

cd ~/qdrant   # qdrant 실행 파일 있는 폴더로 이동 (본인 경로)

curl -L https://github.com/qdrant/qdrant-web-ui/releases/latest/download/dist-qdrant.zip -o dist-qdrant.zip

mkdir -p static
sudo apt install unzip # unzip 미 존재 시 설치
unzip dist-qdrant.zip -d static

 

 

---

3. 대시보드 static 폴더 구조 정리

대시보드 폴더 구조가 한단계 더 들어가 있던 것을 static/ 디렉토리로 옮겨주면 됩니다.

cd ~/qdrant
mv static/dist/* static/
rmdir static/dist
ls static/
# index.html 등이 static/ 바로 아래 있어야 정상

 

---

4. Qdrant 실행 및 정상 동작 확인

Qdrant 실행파일을 실행하면 아래와 같이 실행됩니다. 

./qdrant

INFO qdrant::tonic: Qdrant gRPC listening on 6334

 

 

정상 동작을 확인하려면 아래와 같이 curl로 호출하거나 대시보드를 웹 브라우저로 띄워보면 됩니다. Qdrant의 기본 포트는 6333번 포트입니다.

curl http://localhost:6333/
# {"title":"qdrant - vector search engine", ...}


http://localhost:6333/dashboard/ # qdrant 대시보드 주소

 

curl 호출 결과 : 

 

Qdrant 대시보드 실행 결과 : 

 

---

5. 참고 자료

• https://github.com/nlweb-ai/NLWeb/diffs/3?base_sha=724b681f5ca0ab7501fb5cf5ab2654cfefb4cb99&head_user=CK-NZ&name=main&pull_number=148&sha1=724b681f5ca0ab7501fb5cf5ab2654cfefb4cb99&sha2=5fa1704525196dd92ce925bda0803be60893f8b2&short_path=ae2bf9a&w=false
• https://qdrant.tech/documentation/installation/#from-source