Open WebUI
Open WebUI는 완전한 오프라인 구동을 목표로 설계된, 확장성 높고 기능이 풍부하며 사용하기 쉬운 오픈 소스 셀프 호스팅 AI 플랫폼입니다. Ollama와 OpenAI 호환 API를 모두 지원하여, 로컬 모델과 클라우드 기반 모델 양쪽에 두루 쓸 수 있는 강력한 공급자 독립적(provider-agnostic) 솔루션입니다.
1동작 원리¶
Open WebUI는 공급자 독립적 프론트엔드로서, 사용자의 요청을 공급자 API로 전달하고 모델 추론 결과를 실시간으로 스트리밍해 보여줍니다. 전체 흐름은 다음과 같습니다.
2설치¶
2.1Docker¶
Open WebUI는 도커 이미지를 제공합니다.
bash
PowerShell
docker run -d \
--name open-webui \
-p 8080:8080 \
-v openwebui_data:/app/backend/data \
ghcr.io/open-webui/open-webui:maindocker run -d `
--name open-webui `
-p 8080:8080 `
-v openwebui_data:/app/backend/data `
ghcr.io/open-webui/open-webui:main다음은 Open WebUI 단일 서비스 컴포즈 예시입니다. 여기에 Ollama·vLLM 같은 LLM 백엔드 서비스를 같은 컴포즈에 추가해 함께 구성할 수도 있습니다.
services:
open-webui:
image: ghcr.io/open-webui/open-webui:main
container_name: open-webui
ports:
- "8080:8080"
volumes:
- openwebui_data:/app/backend/data
volumes:
openwebui_data:docker/compose.openwebui.yaml
컴포즈 파일을 지정하여 다음 명령으로 서비스를 백그라운드로 실행할 수 있습니다.
docker compose -f docker/compose.openwebui.yaml up -d2.2직접 설치¶
운영체제에 직접 설치해 실행할 수 있습니다.
uv를 사용하는 것을 권장합니다.
uvx는 임시 환경에서 실행되므로, 데이터가 사라지지 않도록 DATA_DIR로 보존할 폴더를 지정합니다.
bash
PowerShell
DATA_DIR="$HOME/open-webui" uvx --python 3.11 open-webui@latest serve$env:DATA_DIR = "$HOME\open-webui"
uvx --python 3.11 open-webui@latest serve구동 후 웹 브라우저에서 http://localhost:8080으로 접속합니다.
첫 접속 시 등록하는 계정이 관리자 계정이 되며, 이때부터 로컬 추론 기반의 비공개 대화 환경을 곧바로 사용할 수 있습니다.
3주요 기능¶
Open WebUI의 핵심 기능은 주제별 전용 장에서 자세히 다룹니다.