Dify를 Linux 환경에 설치하는 방법
리눅스를 처음 접하는 분들에게는 검은 바탕에 흰 글씨만 가득한 터미널(Terminal)이 어렵게 느껴질 수 있습니다.
하지만 걱정하지 마세요. 내 컴퓨터(서버)에서 Dify를 바로 사용할 수 있도록 설치 과정을 최대한 쉽게 알려드릴게요.
저는 Ubuntu 22.04 LTS에 Dify (CE) v1.10.0 버전을 설치해 보겠습니다.
1. 컴퓨터(서버) 사양 확인하기
요리를 시작하기 전에 재료를 확인하듯, Dify를 설치하기 전에 내 컴퓨터(서버) 사양부터 확인해야 합니다. Dify를 사용하기 위한 최소 사양은 아래와 같습니다.
CPU : 2 Core 이상
RAM : 4 GiB 이상
설치를 진행하려면 Dify가 올라가기 위한 몇 가지 필수 프로그램도 설치해야 합니다.
바로 Docker, Docker Compose, Git, Jq 네 가지예요.
“이게 뭘까?” 싶으실 수도 있지만, 걱정하지 않으셔도 됩니다.
따라 하기 쉽게 하나씩 알려드릴게요.
2. 사전 패키지 설치하기 (준비 단계)
가장 먼저 컴퓨터(서버)의 터미널을 열어주세요.
Dify를 설치하기 위해 사전에 필요한 패키지들이 이미 설치되어 있지 않다고 가정하고 하나씩 설치해볼 거에요.
보통은 git이나 jq 같은 도구가 없는 경우 에러 메시지가 나오니, 처음부터 마음 편하게 필요한 프로그램들을 쭉 설치하고 시작하는 것이 좋습니다.
아래 명령어들을 한 줄씩 입력하고 엔터를 눌러주세요.
1) Git (코드 복사 도구) 설치
소스코드 복사 도구입니다. 이미 설치된 경우도 많지만, 혹시 모르니 확인해 봅니다.apt install git
2) Jq (데이터 처리 도구) 설치
데이터를 가공해주는 툴로, 최신 Dify 버전을 확인할 때 쓰입니다.apt install jq
3) Docker (프로그램 실행 엔진) 설치
Dify를 실행할 가상화 환경 (도커 컨테이너) 역할을 합니다.apt install docker
4) Docker Compose (도커 관리 도구) 설치
도커 컨테이너를 효율적으로 관리해 주는 도구예요.apt install docker-compose
잠깐! 설치 중에 물어보는 게 있다면?
명령어를 입력했을 때Do you want to continue? [Y/n]같은 문구가 나온다면, 키보드에서 Y를 누르고 엔터를 치시면 됩니다.
혹시 커널 업데이트 등 분홍색 이나 보라색 화면이 나와도 당황하지 말고 엔터를 눌러OK를 선택하고 넘어가 주세요.
참고로-y옵션을 끝에 입력하면 물어보지 않고 다음 과정으로 진행됩니다.
3. Dify 소스 코드 내려받기
이제 준비가 끝났으니, 본격적으로 Dify 소스 코드를 내려받아 봅시다.
이런 과정을 '클론(clone)'이라고 부르는데, 인터넷에 저장된 소스코드를 내 컴퓨터로 복사해 오겠다는 뜻이에요.
조금 길어 보이지만, 아래 명령어를 복사해서 붙여 넣고 엔터만 누르시면 됩니다.
git clone --branch "$(curl -s https://api.github.com/repos/langgenius/dify/releases/latest | jq -r .tag_name)" https://github.com/langgenius/dify.git
별다른 에러 메시지가 없다면 성공적으로 코드를 내려받으신 거예요.
4. 설정 파일 준비하고 실행하기
이제 다운로드한 Dify 폴더에 들어가서 실행 준비를 마칠 차례입니다.
1) 폴더 이동하기
방금 다운로드한 파일이 있는 위치로 들어갑니다.cd dify/docker
2) 환경 설정 파일 만들기
Dify가 작동하려면 설정 파일이 필요합니다.
기본 예제 파일(env.example)을 복사해서 실제로 사용될 설정 파일(.env)을 만드는 과정입니다.cp .env.example .env
3) Dify 실행하기 (도커 컨테이너 실행)
이제 실행 명령만 입력하면 Dify가 시작됩니다.docker-compose up -d
(혹시 최신 버전의 Docker를 사용 중이라면 docker compose up -d라고 입력해야 할 수도 있습니다.)
이 명령어를 치고 나면 화면에 Starting... 또는 Started 같은 메시지가 뜨면서 여러 가지 프로그램들이 쭉 실행됩니다.
이런 메시지가 보이면, 설치가 제대로 잘 되고 있다는 뜻이에요.
5. Dify 접속하고 관리자 계정 만들기
설치와 실행이 모두 끝났다면, 이제 인터넷 브라우저(크롬이나 엣지 등)를 열고 Dify에 접속해 봅시다.
서버(리눅스, 클라우드)에 설치한 경우:
브라우저 주소창에http://여러분의_서버_IP/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를 백업 받아주세요!
필수 요소 설치가 되지 않아 에러가 발생한 경우
[ git clone 성공한 경우 ]
에러가 발생했어요!
1. Command ‘git’ not found 에러가 발생합니다.apt-get install gitapt install git
입력하고 엔터를 입력합니다.
Do you want to continue? 가 나오면 Y를 입력합니다.
커널 업데이트 등이 나오면 엔터를 눌러 OK를 진행합니다.
2. Command ‘jq’ not found 에러가 발생합니다.
apt install jq 를 입력하고 엔터를 입력합니다.
Do you want to continue? 가 나오면 Y를 입력합니다.
커널 업데이트 등이 나오면 엔터를 눌러 OK를 진행합니다.
3. Command ‘docker’ not found 에러가 발생합니다.apt install docker
입력하고 엔터를 입력합니다.
Do you want to continue? 가 나오면 Y를 입력합니다.
커널 업데이트 등이 나오면 엔터를 눌러 OK를 진행합니다
4. Command ‘docker-compose’ not found 에러가 발생합니다.
apt install docker-compose
입력하고 엔터를 입력합니다.
Do you want to continue? 가 나오면 Y를 입력합니다.
커널 업데이트 등이 나오면 엔터를 눌러 OK를 진행합니다
참고 자료: Dify Self-Host 설치 가이드
https://docs.dify.ai/en/self-host/quick-start/docker-compose
문의가 필요하신 경우 아래의 링크로 자유롭게 문의 부탁드립니다.
오픈소스 문의: https://discord.com/invite/FngNHpbcY7
엔터프라이즈 도입 문의: ai@open-network.co.kr