커뮤니티 솔루션

ZimaOS에서 Ollama 모델을 Open WebUI에 연결하는 방법

A ZimaOS discussion comparing a failed model-download and GPU-detection attempt with a confirmed Ollama-Nvidia and Open WebUI setup running on an RTX 3060 server.

원래 커뮤니티 질문은 이미 서로 다른 컴퓨터에서 Ollama와 Open WebUI를 실행하고 있었지만 ZimaOS 앱으로는 동일한 구성을 재현하지 못한 ZimaOS 사용자에게서 시작되었습니다. 사용자는 두 애플리케이션을 모두 열 수 있었지만 Open WebUI에서 Ollama 모델을 다운로드하거나 표시하지 못했고, 시스템에서도 NVIDIA GPU를 인식하지 못하는 것처럼 보였습니다.

논의에서는 보편적으로 적용할 수 있는 단일 해결책이 나오지 않았습니다. 대신 세 가지 서로 다른 결과가 기록되었습니다. 작성된 그대로는 실행할 수 없었던 불완전한 docker exec 명령, NVIDIA 가속을 위한 ZimaOS 설치 순서 권장 사항, 그리고 RTX 3060 서버에서 Ollama-NvidiaOpen WebUI가 성공적으로 작동했다는 이후 커뮤니티 보고입니다. 이 논의를 하나의 해결된 튜토리얼로 제시하기보다는 이러한 경로를 구분하는 편이 더 유용합니다.

원래 docker exec 명령이 실패한 이유

작성자가 처음 받은 조언은 SSH로 연결한 뒤 실행하라는 것이었습니다. sudo docker ps, Ollama 컨테이너 ID를 복사한 다음 sudo docker exec. Docker가 오류를 반환한 이유는 docker exec 실행 중인 컨테이너와 그 안에서 실행할 명령이 모두 필요합니다.

docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

예를 들어 완전한 명령에는 컨테이너 식별자 뒤에 실제 명령이 와야 합니다. 커뮤니티 게시글에서는 정확한 Ollama 컨테이너 이름이나 실행하려던 명령을 제공하거나 확인하지 않았으므로, 복사해 붙여 넣을 수 있는 명령을 임의로 만들어 포럼의 해결책이라고 부르는 것은 안전하지 않습니다.

더 큰 문제는 단순히 터미널 문법에만 있지 않았습니다. 작성자는 Open WebUI를 통해 모델을 가져오려고 했지만 화면에 아무런 결과가 나타나지 않았고 GPU도 감지되지 않았다고 보고했습니다. 동일한 구성을 계획하는 사용자는 인터페이스 문제와 추론 하드웨어 문제를 구분하기 전에 Ollama 하드웨어 요구 사항Open WebUI 하드웨어 요구 사항을 확인할 수 있습니다.

Open WebUI를 별도의 Ollama 인스턴스에 연결하기

Zima-Giorgio는 먼저 작성자에게 Open WebUI의 Ollama 연결 문서를 안내했습니다. 사용자의 Ollama 서비스와 Open WebUI 서비스가 서로 다른 환경에서 실행 중일 수 있었기 때문입니다. 현재 Open WebUI Ollama 제공자 가이드에서는 이 설정을 관리자 설정 → 연결 → Ollama → 관리에서 진행하도록 안내합니다.

중요한 아키텍처상의 요점은 Open WebUI가 인터페이스이고 Ollama가 모델을 제공하는 백엔드라는 것입니다. 서비스가 서로 다른 컨테이너에 있거나 서로 다른 컴퓨터에서 실행되는 경우 Open WebUI가 네트워크를 통해 Ollama API에 연결할 수 있어야 합니다. Ollama에 존재하는 모델은 두 앱 아이콘이 모두 설치되어 있다는 이유만으로 표시되지 않습니다.

연결에 실패하는 경우, 공식 Open WebUI 연결 가이드에서는 Ollama가 일반적으로 127.0.0.1에서 수신 대기하며, 이 주소는 다른 컨테이너나 컴퓨터에서 접근할 수 없다고 설명합니다. 이 문서는 유용한 참고 자료이지만, 포럼에서는 이것이 작성자의 ZimaOS 설치 환경에서 발생한 정확한 원인이라고 확인하지 않았습니다.

스레드에서 제안된 NVIDIA 설치 순서

2025년 2월에 제공된 ZimaOS 앱 스토어 설치 경로에 대해 Zima-Giorgio는 이전에 설치한 Open WebUI 앱을 제거하고, 먼저 NVIDIA GPU 지원을 설치한 다음 Open WebUI를 다시 설치할 것을 제안했습니다.

  1. GPU 지원을 설치하기 전에 기존 Open WebUI가 설치되어 있었다면 제거합니다.
  2. NVIDIA GPU 지원 또는 GPU 전용 Ollama 앱을 설치합니다.
  3. GPU 계층을 사용할 수 있게 된 후 Open WebUI를 설치합니다.

답변에서는 이를 나중에 수정될 수 있는 일시적인 제한 사항이라고 명시적으로 설명했습니다. 따라서 이는 해당 스레드의 당시 작업 흐름으로 보아야 하며, 현재의 모든 ZimaOS 릴리스에 적용되는 영구적인 규칙으로 간주해서는 안 됩니다.

원 작성자는 이 순서가 자신의 컴퓨터에서 문제를 해결하지 못했다고 보고했습니다. 결국 Linux Mint를 설치하고 Linux에서 NVIDIA GPU를 인식하는지 확인한 다음 Docker GPU 액세스를 구성하고 CasaOS를 설치한 뒤, 터미널을 통해 Ollama와 Open WebUI를 설치했습니다. 이 환경에서는 Open WebUI가 모델을 다운로드할 수 있었습니다.

Open WebUI는 Ollama 모델을 직접 가져올 수 있나요?

Zima-Giorgio는 나중에 팀 영상에 소개된 ZimaOS Open WebUI 배포에 Ollama가 포함되어 있으며, 인터페이스를 통해 모델을 직접 가져올 수 있다고 설명했습니다. 이 설명에 따르면 별도의 수동 ollama run modelname 해당 패키지 배포에서는 command가 항상 필요하지는 않았습니다.

토론에서 해당 동영상은 두 번 공유되었지만, 원 작성자는 동영상이 자신의 특정 모델 다운로드 및 GPU 감지 문제를 해결하지 못했다고 말했습니다. 이 동영상은 패키지된 워크플로의 시각적 참고 자료로는 남아 있지만, 모든 설치가 동일하게 작동한다는 증거는 아닙니다.

RTX 3060에서 작동한 커뮤니티 설정

이후 Denzil은 ZimaOS에서 작동한 가장 명확한 성공 사례를 공유했습니다. 구형 Lenovo 서버에 NVIDIA RTX 3060을 장착한 상태에서 사용자는 Ollama-NvidiaOpen WebUI 앱을 설치했습니다. Ollama는 GPU를 사용했고, Open WebUI는 Ollama 인스턴스를 감지했으며, 로컬 네트워크의 브라우저에서 포트 3050을 통해 인터페이스에 접속할 수 있었습니다.

이 설정은 텍스트 프롬프트에서 작동했습니다. Denzil은 브라우저 인증서가 필요하기 때문에 음성 입력을 활성화하지 않았으므로, 음성 기능까지 구성되었다고 확대 해석해서는 안 됩니다. 별도의 Home Assistant 머신이 음성 채팅 LLM 쿼리를 위해 Ollama 서버에 연결되었습니다.

9개월 후 Denzil은 Lenovo와 RTX 3060 설치 환경이 거의 중단 없이 실행되고 있다고 보고했습니다. 동일한 ZimaOS 서버에서는 Immich, Jellyfin, Joplin 관련 워크플로, 파일 공유 및 기타 셀프 호스팅 서비스도 실행되고 있었습니다. 이 후속 보고는 해당 사용자의 NVIDIA 설정이 장기간 안정적으로 작동했음을 뒷받침하지만, 원 작성자의 설치가 실패한 이유를 설명하지는 않습니다.

NVIDIA와 Intel GPU의 범위

성공 사례에서는 NVIDIA RTX 3060을 사용했습니다. 사용자는 현재 Ollama GPU 지원 문서에서 자신의 카드를 비교하고, 호스트 운영 체제와 컨테이너 런타임 모두 GPU를 인식할 수 있는지 확인해야 합니다.

다른 사용자가 Intel GPU가 Open WebUI에서 작동하지 않은 이유를 물었습니다. 이 스레드에는 검증된 Intel 해결 방법이 게시되지 않았습니다. Denzil은 Intel 카드 사용 경험이 없다고 명시하고 ZimaCube GPU 확장 가이드를 링크했습니다. 따라서 Intel 관련 질문은 해결되지 않은 상태로 남았으며, RTX 3060 결과를 바탕으로 추론해 답변해서는 안 됩니다.

논의를 바탕으로 한 실용적인 체크리스트

  1. Open WebUI에 로컬 Ollama 백엔드가 포함되어 있는지, 아니면 별도의 Ollama 인스턴스에 연결해야 하는지 확인하세요.
  2. 서비스가 분리되어 있다면 Open WebUI에서 Ollama 연결 URL을 설정하고 11434 포트에 연결할 수 있는지 확인하세요.
  3. NVIDIA 가속을 사용하는 경우 Open WebUI를 진단하기 전에 호스트에서 GPU가 감지되는지 확인하세요.
  4. 컨테이너 런타임이 Ollama 컨테이너에 GPU를 노출하는지 확인하세요.
  5. 스레드에서 논의된 당시의 ZimaOS 앱 버전에서는 Open WebUI를 다시 설치하기 전에 GPU 지원을 설치하세요.
  6. Open WebUI를 통해 모델을 가져온 다음 모델 선택기에 해당 모델이 표시되는지 확인하세요.
  7. 모델을 계속 사용할 수 없다면 불완전한 를 실행하는 대신 Open WebUI 연결 상태, Ollama 로그, 컨테이너 이름, GPU 감지 출력을 수집하세요. docker exec 명령어입니다.

CPU만 사용하거나 저전력 환경에서 실험하려는 경우, GPU 없이 홈 NAS에서 로컬 AI를 실행하는 방법을 다룬 Shop 가이드(전용 GPU 없이 홈 NAS에서 실행할 수 있는 로컬 AI 작업 알아보기)를 참고하면 현실적인 모델 크기와 성능을 가늠하는 데 도움이 됩니다.

ZimaOS의 Ollama 및 Open WebUI FAQ

docker exec에서 인수가 최소 두 개 필요하다고 표시된 이유는 무엇인가요?

명령어가 완전하지 않았습니다. Docker에서는 실행 중인 컨테이너 식별자 또는 이름 뒤에 해당 컨테이너 내부에서 실행할 명령어가 필요합니다.

Open WebUI에서 Ollama 모델을 직접 다운로드할 수 있나요?

Zima-Giorgio의 답변과 공유된 영상에 따르면, 패키지로 제공되는 Open WebUI 배포판은 인터페이스를 통해 모델을 가져올 수 있었습니다. 하지만 원 작성자는 여전히 다운로드에 실패했으므로 Ollama 연결 상태와 GPU/컨테이너 상태도 확인해야 합니다.

답변에서 어떤 ZimaOS 앱 조합이 작동했나요?

Denzil은 RTX 3060이 장착된 Lenovo 서버에서 Ollama-Nvidia와 Open WebUI를 성공적으로 사용했다고 보고했습니다. Open WebUI는 Ollama에 연결되었고 LAN을 통해 3050 포트에서 접속할 수 있었습니다.

스레드에서 Intel GPU 해결 방법을 제시했나요?

아니요. Intel GPU 문제는 여전히 해결되지 않았으며, 성공한 구성에서는 NVIDIA 하드웨어를 사용했습니다.

GPU 지원 후 Open WebUI를 제거하고 다시 설치해야 하나요?

2025년 2월 답변에서는 해당 순서를 ZimaOS의 일시적인 제한으로 설명했습니다. 기존 설치를 제거하기 전에 현재 앱 동작을 확인하고, 먼저 영구 애플리케이션 데이터를 백업하세요.