3. Open WebUI 로컬 환경설정 및 실행

필수

1. Docker 설치

2. git clone으로 소스 다운 받기

옵션

1. Ollama 설치(로컬 LLM을 사용할 경우 필수)

Open WebUI 소스 다운 받기

테디님이 만들어 둔 github을 통해서 다운을 받으면 됩니다.

링크 : https://github.com/teddylee777/dify-openwebui

git clone https://github.com/teddylee777/dify-openwebui

보통 저는 github라는 폴더에 clone을 합니다.

.env 파일 설정

clone한 폴더에 들어가면 docker라는 폴더가 있습니다. 이 폴더에 들어가면 .env.teddynote라는 파일이 있는데 이 파일을 .env로 이름을 변경합시다.

.env파일을 열어보고 제일 하단으로 내려보면 아래와 같은 설정을 볼 수 있습니다. OPENWEBUI_LOCAL_DATA, PIPELINES_LOCAL_DATA, LANGFLOW_LOCAL_DATA, LANGFLOW_LOCAL_POSTGRES_DATA 4곳에 대한 경로를 본인의 컴퓨터 경로에 맞게 수정합니다.

# OpenWebUI Data
# Windows
OPENWEBUI_LOCAL_DATA=D:/GitHub/Fork-dify-openwebui/openwebui

# Pipelines Data
# Windows
PIPELINES_LOCAL_DATA=D:/GitHub/Fork-dify-openwebui/pipelines

# Langflow Data
# Windows
LANGFLOW_LOCAL_DATA=D:/GitHub/Fork-dify-openwebui/langflow

# Langflow Postgres Data
# Windows
LANGFLOW_LOCAL_POSTGRES_DATA=D:/GitHub/Fork-dify-openwebui/langflow-postgres

docker 실행

1. 이제 내려 받은 소스로 docker를 실행해야 합니다. 먼저 터미널(windows라면 명령 프롬프트 또는 파워셀)을 열어서 .env와 docker-compose-teddynote.yaml 파일이 있는 docker 폴더로 이동합니다.

2. docker-compose 실행

docker-compose -f docker-compose-teddynote.yaml up -d

처음 실행한 상황이면 이미지를 다운 받아야 함으로 시간이 걸린다. 다운이 완료되면 자동으로 실행까지 연결됩니다.

정상적으로 실행된 케이스

웹 브라우저로 localhost:3000에 접속해서 Open WebUI가 실행되면 정상적으로 설치되어 성공한 것이다.

실행이 안될 때 체크 사항

1. docker login이 되어 있는지 확인(최초 1번)

2. docker desktop이 실행 중인지 확인

   • 재부팅하거나 설정을 바꾸면 docker desktop을 재실행하는 것을 추천한다.

One WebUI 로그인 및 설정

http://localhost:3000에 접속해서 계정을 하나 만들고 그 계정으로 로그인을 합니다.

로그인을 하면 화면 왼쪽 하단에 사용자 이름을 클릭하면 관리자 패널이 나옵니다. 이 관리자 패널을 클릭해서 설정에 들어갑시다.

여기서 설정 탭에 들어갑니다. 그 다음 연결 탭에 들어가면 API 연결 관리가 나옵니다.

http://host.docker.internal:9099이 없을 것입니다. 그러면 오른쪽에 있는 +을 눌러서 추가해줍시다.

아래와 같이 URL에는 http://host.docker.internal:9099을 입력하고 Key에는 0p3n-w3bu!을 입력하여 저장합니다.

여기까지 잘 설정되었으면 Dify 접속이 가능합니다.

Dify 접속은 아래 링크로 접속하면 된다. 참고로 localhost이므로 로컬 Dify로 접속됩니다. 인터넷으로 연결되는 Dify 사이트하고 독립적입니다.

http://localhost/apps