Open WebUI 빠른 시작 — Docker로 띄우기

Open WebUI 빠른 시작 — Docker로 띄우기

Open WebUI는 macOS·Linux(x86_64와 ARM64, 라즈베리파이·NVIDIA DGX Spark 포함)·Windows에서 동작해요. 대부분의 사용자에게 Docker 방식이 공식 권장됩니다.

출처: https://docs.openwebui.com/getting-started/quick-start/

Docker로 실행

이미지는 GitHub Container Registry(ghcr.io/open-webui/open-webui)와 Docker Hub(openwebui/open-webui) 양쪽에 동일하게 게시돼 있어 어느 쪽이든 쓰면 됩니다. WebSocket 지원이 필요하니 네트워크 설정을 확인하세요.

docker pull ghcr.io/open-webui/open-webui:main

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
Flag Purpose
-v open-webui:/app/backend/data Persistent storage. Prevents data loss between restarts.
-p 3000:8080 Exposes the UI on port 3000 of your machine.

이제 브라우저에서 http://localhost:3000으로 접속하면 됩니다.

이미지 태그 고르기

  • :main — 표준 이미지(권장), 그리고 :latest는 main 브랜치 최신 빌드를 가리키는 롤링 태그.
  • :main-slim — 더 작은 이미지, 첫 사용 시 Whisper·임베딩 모델을 내려받음.
  • :cuda — NVIDIA GPU 지원 (--gpus all 추가).
  • :ollama — 컨테이너 안에 Ollama를 포함한 올인원 구성.
  • :vX.Y.Z — 특정 안정 릴리스에 고정(pinning)되는 불변 태그.

재현 가능한 프로덕션 배포라면 버전 태그를 고정하고, 최신 빌드를 원하면 :main을 쓰면 돼요. GPU·올인원 구성 예시는 이렇습니다.

docker run -d -p 3000:8080 --gpus all -v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:cuda

# With GPU
docker run -d -p 3000:8080 --gpus=all -v ollama:/root/.ollama -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:ollama

첫 로그인과 모델 연결

첫 계정은 관리자 권한을 받아 사용자 관리와 시스템 설정을 관장해요. 기본적으로 모든 데이터가 로컬에 저장되고 외부 요청을 보내지 않으며, 모델도 기본값이 비공개라 명시적으로 공유해야 합니다. 채팅을 시작하려면 모델 제공자(Ollama, OpenAI, OpenAI 호환 API, Anthropic, vLLM 등) 하나를 연결해야 해요.

WEBUI_AUTH=False로 두면 인증 없이 단일 사용자 모드로 쓸 수 있는데, 이후에 계정 모드로 되돌릴 수 없다는 점만 주의하세요. 컨테이너를 재생성할 때마다 로그아웃되지 않으려면 WEBUI_SECRET_KEY를 고정값으로 설정하는 게 좋아요(openssl rand -hex 32로 생성).

더 알아보기