Open WebUI 설치하고 Ollama에 연결하기

UI 문제와 모델 문제를 분리하려면 터미널에서 모델이 먼저 응답해야 합니다.

‘Ollama부터 확인합니다’ 단계에서 기준으로 삼을 원칙은 “Ollama가 먼저 정상 응답하는지 확인한 뒤 UI를 추가합니다.”입니다. 설치 성공 여부는 화면이 열리는지만으로 판단하지 않습니다. 버전, 실행 경로, 포트와 데이터 저장 위치까지 확인해야 다음 단계의 오류를 설치 문제와 분리할 수 있습니다.

명령이나 코드는 그대로 복사해 실행한 뒤 끝내지 말고 종료 상태, 출력 로그와 생성된 파일·프로세스를 함께 확인합니다. 실패하면 여러 설정을 동시에 바꾸지 말고 입력, 버전, 권한, 자원 조건을 하나씩 되돌려 같은 절차를 다시 실행해야 원인을 남길 수 있습니다.

ollama run gemma3:4b

공식 Quick Start의 이미지를 사용하고 영구 볼륨을 연결합니다. 태그와 명령은 배포 시점 문서에서 다시 확인하세요.

‘컨테이너를 실행합니다’ 단계에서 기준으로 삼을 원칙은 “호스트의 Ollama에 연결할 때 운영체제와 Docker 네트워크 차이를 확인합니다.”입니다. 설치 성공 여부는 화면이 열리는지만으로 판단하지 않습니다. 버전, 실행 경로, 포트와 데이터 저장 위치까지 확인해야 다음 단계의 오류를 설치 문제와 분리할 수 있습니다.

예제 실행 전에는 현재 버전과 설정을 기록하고, 실행 후에는 기대한 응답·파일·프로세스가 실제로 생겼는지 확인합니다. 오류 메시지를 보존한 채 가장 작은 명령으로 되돌아가면 설치 문제와 입력 문제를 구분하기 쉽습니다.

docker run -d -p 3000:8080 -v open-webui:/app/backend/data --name open-webui --restart always ghcr.io/open-webui/open-webui:main

브라우저에서 localhost:3000을 열고 모델 목록을 확인합니다. Docker에서 호스트 Ollama가 보이지 않으면 공식 Ollama 연결 안내에 따라 호스트 주소를 설정합니다.

‘연결과 로그인을 점검합니다’ 단계에서 기준으로 삼을 원칙은 “데이터 볼륨과 로그인 설정 없이 외부에 포트를 공개하지 않습니다.”입니다. 설치 성공 여부는 화면이 열리는지만으로 판단하지 않습니다. 버전, 실행 경로, 포트와 데이터 저장 위치까지 확인해야 다음 단계의 오류를 설치 문제와 분리할 수 있습니다.

완료 여부는 느낌이 아니라 관찰 가능한 기준으로 정합니다. 같은 입력을 반복했을 때 결과가 유지되는지 확인하고, 달라진다면 버전·설정·데이터 가운데 어떤 조건이 원인인지 좁힌 뒤 다음 단계로 넘어갑니다.

기본 설치는 개인 PC의 localhost용으로 다룹니다. 다중 사용자나 인터넷 공개에는 인증, TLS, 백업, 업데이트와 접근 로그 설계가 필요합니다.

‘외부 공개 전에 멈춥니다’ 단계에서 기준으로 삼을 원칙은 “Ollama가 먼저 정상 응답하는지 확인한 뒤 UI를 추가합니다.”입니다. 설치 성공 여부는 화면이 열리는지만으로 판단하지 않습니다. 버전, 실행 경로, 포트와 데이터 저장 위치까지 확인해야 다음 단계의 오류를 설치 문제와 분리할 수 있습니다.

검증할 때는 모델·런타임 버전, 입력 자료, 주요 설정과 결과를 한 묶음으로 저장합니다. 다른 조건을 그대로 둔 채 한 요소만 바꾸어 다시 실행하고, 예상과 다른 결과와 아직 확인하지 못한 한계까지 기록해야 이 설명을 자신의 환경에 안전하게 적용할 수 있습니다.