Open WebUI 커스터마이징 준비 방법 정리

필수 전제 조건

python 3.11 설치 완료 및 환경변수 설정 완료

node.js 버전은 18.13.0 ~ 22.x.x 

open web ui 깃허브 클론이든 포크든 일단 가져와야함.

 

1. 커스터마이징(개발) 트랙에선 프로젝트 폴더의 backend 폴더에서 `pip install -r requirements.txt` 명령어를 실행해서 의존성 다운
2. 프로젝트의 백엔드 실행은 `start_windows.bat` 파일을 사용하여 실행한다.
   또는 uvicorn으로 실행해야함. 
   `python -m uvicorn open_webui.main:app --port 8080 --reload`
   --reload는 코드 고칠 때마다 백엔드 자동 재시작 옵션
3. 백엔드가 정상적으로 떠 있는지 확인한다.
   (open-webui serve는 기본적으로 http://localhost:8080에서 동작함.)
4. 프론트엔드 개발 서버 주소(npm run dev 실행 시 터미널에 표시됨, 보통 http://localhost:5173)로 브라우저에서 접속한다.
5. 프론트엔드가 백엔드 API를 바라보도록 환경변수를 설정한다. 프로젝트 루트의 .env 파일에서 백엔드 주소(예: OPENAI_API_BASE_URL 또는 BACKEND_URL)를 http://localhost:8080으로 맞춰준다.
6. Ollama 등 LLM 백엔드를 함께 사용하는 경우, 해당 서비스(ollama serve)도 미리 실행해 두고 모델이 받아져 있는지 확인한다(ollama list).
7. 브라우저 접속 후 첫 화면에서 관리자 계정을 생성하고 로그인한다.
   계정을 만들면 WEBUI_AUTH 변수를 False로 변경하더라도 설정값을 무시하고 계속 로그인 화면을 띄움
   ( 관리자 계정을 사용하지 않고 바로 채팅을 하도록 만들거라면
   백엔드 폴더의 env.py 에서 WEBUI_AUTH 변수를 찾아서 False로 설정할 것.
   이미 계정을 만들어버렸다면, 백엔드 끄고 backend\data\webui.db 삭제(DB 초기화)
   $env:WEBUI_AUTH="False" 넣고 재시작)
8. 설정(Settings) → 연결(Connections)에서 모델 엔드포인트가 정상 연결되었는지 확인하면 실행 완료.

추가로, 매번 개발 서버를 띄우지 않고 그냥 사용만 할 거라면 npm run dev 대신 npm run build로 빌드한 뒤 open-webui serve만 실행해도 통합된 화면(http://localhost:8080)에서 바로 쓸 수 있다.

 

여기서부터 커스터마이징 하면됨.

 

변수값을 변경하지 않을거라면

매 실행마다 실행할 cmd 창에서

$env:WEBUI_AUTH = "False"
echo $env:WEBUI_AUTH

을 이용해서 해당 프롬프트창에서 값이 False로 나오는지 확인하고

해당 프롬프트창에서 백엔드 실행 명령어를 입력해서 실행해야함.