Ubuntu 24.04에 OpenWebUI 로컬 AI 인터페이스 배포

Source: Dev.to

디렉터리 구조 설정

1. 프로젝트 디렉터리 만들기

mkdir -p ~/openwebui/data
cd ~/openwebui

2. 환경 파일 만들기

nano .env

다음 변수를 추가합니다:

DOMAIN=openwebui.example.com
LETSENCRYPT_EMAIL=admin@example.com

Docker Compose 로 배포

1. Docker Compose 매니페스트 만들기

nano docker-compose.yaml

다음 내용을 붙여넣습니다:

services:
  traefik:
    image: traefik:v3.6
    container_name: traefik
    command:
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "--entrypoints.web.http.redirections.entrypoint.to=websecure"
      - "--entrypoints.web.http.redirections.entrypoint.scheme=https"
      - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
      - "--certificatesresolvers.letsencrypt.acme.httpchallenge.entrypoint=web"
      - "--certificatesresolvers.letsencrypt.acme.email=${LETSENCRYPT_EMAIL}"
      - "--certificatesresolvers.letsencrypt.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "letsencrypt:/letsencrypt"
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
    restart: unless-stopped

  openwebui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: openwebui
    hostname: openwebui
    expose:
      - "8080"
    volumes:
      - "./data:/app/backend/data"
    environment:
      - WEBUI_AUTH=true
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.openwebui.rule=Host(`${DOMAIN}`)"
      - "traefik.http.routers.openwebui.entrypoints=websecure"
      - "traefik.http.routers.openwebui.tls.certresolver=letsencrypt"
      - "traefik.http.services.openwebui.loadbalancer.server.port=8080"
    restart: unless-stopped

volumes:
  letsencrypt:

2. 서비스 시작

docker compose up -d

3. 서비스가 실행 중인지 확인

docker compose ps

4. 로그 보기

docker compose logs

Open WebUI 접속

브라우저에서 https://openwebui.example.com 을 엽니다. 처음 등록하는 사용자가 관리자 계정이 됩니다. 추가 사용자는 동일한 흐름으로 가입할 수 있으며 관리자 패널 → 사용자에서 관리할 수 있습니다.

다음 단계

Open WebUI가 이제 HTTPS를 통해 안전하게 실행되고 있습니다. 다음을 할 수 있습니다:

• 로컬 Ollama 인스턴스나 OpenAI와 호환되는 어떤 엔드포인트든 모델 백엔드로 연결하기.
• 문서를 지식 베이스에 업로드하여 Retrieval‑Augmented Generation (RAG) 활성화하기.
• 관리자 패널에서 사용자별 모델 권한 및 속도 제한을 설정하기.

전체 가이드와 추가 팁은 Vultr Docs 의 원문을 참고하세요.