Dify를 Windows 환경에 설치하는 방법
윈도우즈 PowerShell이나 cmd를 처음 접하는 분들에게는 검은 바탕에 흰 글씨가 보이는 터미널이 어렵게 느껴질 수 있습니다. 설치 과정을 최대한 쉽게 알려드릴 테니, 이 글을 천천히 따라오시면, Windows 환경에서 작동되는 Dify를 만나보실 수 있습니다. 저는 Windows 11 25H2에 v1.10.0 버전을 설치해 보겠습니다.
1. 설치를 시작하기 전에, 컴퓨터 상태부터 확인해 볼까요?
먼저 설치 전에, 설치하려는 Windows PC가 Dify를 구동할 수 있는지 먼저 확인해야 합니다.
원활하게 Dify를 사용하려면 다음과 같은 기본 사양이 필요해요.
단독으로 운용되는 Linux와 달리 Windows 환경은 권장 사양이 조금 더 높습니다.
CPU : 최소 6 코어 이상이 필요합니다.
RAM : 여유 램 공간이 최소 8기가바이트(GiB) 이상은 되어야 합니다.
OS :
Windows 10 버전 1903 이상, 빌드 18362.1049 이상
Windows 11
그리고 설치를 진행하려면 몇 가지 필수 프로그램도 준비해야 합니다. 바로 Docker, WSL, Git 세 가지입니다.
2. 요구사항 소프트웨어 설치하기 (준비 단계)
이제 Dify를 설치하기 위해 필요한 도구들이 내 컴퓨터에 이미 설치되어 있는지 확인하고, 없다면 하나씩 설치해 볼 거에요.
보통은 WSL이나 git 같은 도구가 없는 경우 에러 메시지가 나오니, 처음부터 편하게 필요한 프로그램들을 미리 설치하고 시작해 봅시다.
아래 명령어들을 한 줄씩 입력하고 엔터를 눌러주세요.
0) WSL을 설치하기 위한 기능 활성화
Windows에서 제공하는 기능 2가지가 먼저 활성화되어야 WSL 설치 및 작동이 가능합니다.
시작 → PowerShell 검색 “Windows PowerShell” 우클릭 → 관리자 권한으로 실행
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestartdism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
명령어 2개를 한 줄씩 입력 후 엔터를 입력합니다.
1) WSL 설치
시작 → PowerShell 검색 “Windows PowerShell” 우클릭 → 관리자 권한으로 실행wsl --install
입력 후 엔터를 입력합니다.
2) Git 설치
소스코드 복사 도구입니다. 보통 윈도우즈에서는 Git을 사용하지 않으니, 기본적으로 설치가 필요합니다.
(https://git-scm.com/install/windows) 으로 접속하셔서 “Click here to download”를 누르시고 다운로드 받은 파일을 실행하시어 설치를 진행합니다.
(Next 버튼 계속 눌러주시면 됩니다.)
3) Docker Desktop(프로그램 실행 엔진) 설치
Dify를 실행할 가상화 환경 (도커 컨테이너) 역할을 합니다.
(https://docs.docker.com/desktop/setup/install/windows-install) 로 접속하셔서, “Docker Desktop for Windows - x86_64”를 클릭하시고 다운로드 받은 설치 파일을 실행하시어 설치를 진행합니다.
3. Dify 소스 코드 내려받기
이제 준비가 끝났으니, 본격적으로 Dify 소스 코드를 내려받아 봅시다.
이런 과정을 '클론(clone)'이라고 부르는데, 인터넷에 저장된 소스코드를 내 컴퓨터로 복사해 오겠다는 뜻이에요.
시작 → cmd → 명령 프롬프트 우클릭 관리자 권한으로 실행을 클릭합니다.
조금 길어 보이지만, 아래 명령어를 복사해서 붙여 넣고 엔터만 누르시면 됩니다.
git clone https://github.com/langgenius/dify.git
별다른 에러 메시지가 없다면 성공적으로 코드를 내려받으신 거예요.
4. 설정 파일 준비하고 실행하기
이제 다운로드한 Dify 폴더에 들어가서 실행 준비를 마칠 차례입니다.
1) 폴더 이동하기
방금 다운로드한 파일이 있는 위치로 들어갑니다.cd dify/docker
2) 환경 설정 파일 만들기
Dify가 작동하려면 설정 파일이 필요합니다. 기본 예제 파일(env.example)을 복사해서 실제로 사용될 설정 파일(.env)을 만드는 과정입니다.copy .env.example .env
3) Dify 실행하기 (도커 컨테이너 실행)
이제 실행 명령만 입력하면 Dify가 시작됩니다.docker compose up -d
이 명령어를 치고 나면 화면에 Starting... 또는 Started 같은 메시지가 뜨면서 여러 가지 프로그램들이 쭉 실행됩니다. 이런 메시지가 보이면, 설치가 제대로 잘 되고 있다는 뜻이에요.
5. Dify 접속하고 관리자 계정 만들기
설치와 실행이 모두 끝났다면, 이제 인터넷 브라우저(크롬이나 엣지 등)를 열고 Dify에 접속해 봅시다.
윈도우즈 + WSL 환경에 설치한 경우:
브라우저 주소창에http://localhost:80/install을 입력하세요.
화면이 나타나면, 관리자 계정을 만들기 위한 아이디와 비밀번호 입력창이 보일 거예요. 이곳에 사용할 정보를 입력하고 계정을 생성하면 설치 과정이 모두 완료됩니다.
이제 Dify 스튜디오 화면이 보이나요? 여기서 챗봇도 만들고, 문서도 연동하면서 여러분만의 Dify를 마음껏 활용할 수 있습니다.
[참고] 나중에 업데이트가 필요할 때
Dify는 계속 새로운 기능이 추가되고 있습니다. 나중에 새로운 버전이 나왔을 때, 업데이트하는 방법도 미리 알려드릴게요. 터미널에서 아래 명령어들을 순서대로 입력하면 됩니다.
Dify 폴더로 이동:
cd dify/docker현재 실행 중인 Dify 중지:
docker compose down최신 소스 코드 가져오기:
git pull origin main최신 이미지 다운로드:
docker compose pull다시 실행하기:
docker compose up -d
이렇게 하면 기존 데이터는 보존하고, 프로그램만 최신 버전으로 업데이트할 수 있습니다. 여기까지 따라오느라 정말 수고 많으셨습니다. 앞으로 Dify와 함께 매일 AI를 손쉽게, 마음껏 즐겨보시길 바랍니다!
주의 사항: 업데이트에 실패할 수 있기 때문에 반드시 먼저 DB를 백업 받아주세요!
에러가 발생했어요!
1. Command ‘git’ not found 에러가 발생합니다.
git 설치를 방금 마친 경우 : PowerShell을 종료한 후 PoweShell 또는 cmd를 다시 실행합니다.
git 설치가 안 된 경우 : 2-2) Git 설치를 참조하여 git 설치를 진행합니다.
Command ‘docker’ not found 에러가 발생합니다.
2-3) Docker 설치 를 참조하여 Docker 설치를 진행합니다.
문의가 필요하신 경우 아래의 링크로 자유롭게 문의 부탁드립니다.
오픈소스 문의: https://discord.com/invite/FngNHpbcY7
엔터프라이즈 도입 문의: ai@open-network.co.kr