All posts

Open WebUI 0.13.0: 탭 작업 공간과 업그레이드 전에 확인할 조건

Open WebUI 0.13.0의 탭 작업 공간과 에이전트 한도 변경을 살펴보고, 데이터베이스 백업과 다중 인스턴스 업데이트 조건을 짚습니다.

채팅, 파일, 터미널 탭과 데이터베이스 백업을 표현한 작업 공간 일러스트

자체 호스팅 AI 채팅 도구 Open WebUI가 2026년 11월 3일 0.13.0을 공개했다. 채팅 옆에 파일, 터미널, 브라우저 등을 띄우는 탭 작업 공간이 추가됐다. 운영자라면 화면을 살펴보기 전에 데이터베이스 백업과 배포 방식을 먼저 확인해야 한다. 이번 릴리스에 스키마 변경이 포함됐기 때문이다.

채팅 옆에서 파일과 터미널을 다룬다

공식 릴리스 노트에 따르면 탭 패널에서 파일, 여러 터미널, 결과물과 미리보기를 열고 배치할 수 있다. 큰 화면에서는 작업 공간을 확장하고 대화를 별도 탭으로 전환할 수도 있다. 브라우저와 데스크톱 탭은 별도로 설정한 Open Terminal 연결을 사용한다. 데스크톱 기능을 쓰려면 해당 연결에서 데스크톱 지원도 켜야 한다.

터미널에서 선택한 폴더가 Git 저장소라면 사이드 패널에서 변경 사항을 살펴보고 스테이징과 커밋, 브랜치와 워크트리 관리 등을 할 수 있다. 실제 명령과 파일에 접근하는 작업인 만큼 공유 환경에서는 연결된 터미널의 권한과 사용 범위를 먼저 점검하는 편이 좋다.

운영 환경에서는 백업과 동시 전환이 우선

릴리스 노트는 업그레이드 전에 데이터베이스와 관련 데이터를 백업하라고 권고한다. 여러 워커나 서버, 로드 밸런서를 쓰는 배포에서는 모든 인스턴스를 함께 업데이트해야 한다. 이전 버전과 새 버전을 섞어 순차 배포하면 스키마 불일치로 애플리케이션이 실패할 수 있다.

공식 업데이트 가이드는 모든 복제본을 멈춘 뒤 한 인스턴스가 마이그레이션을 수행하고 나머지를 새 버전으로 올리는 절차를 안내한다. 마이그레이션은 단방향이다. 이전 컨테이너 이미지로 되돌리는 것만으로 데이터베이스 스키마가 복구되지는 않으므로, 문제가 생길 때를 대비해 업데이트 전 백업의 복구 방법도 확인해야 한다.

에이전트 실행 한도도 살펴보자

이번 버전에서는 native function calling을 사용하는 응답의 도구 호출 상한이 256회에서 1024회로 바뀌었다. 기존 상한을 유지하려면 CHAT_RESPONSE_MAX_TOOL_CALL_ITERATIONS를 256으로 설정할 수 있다. 서브에이전트의 동시 실행, 비동기 실행, 반복 및 출력 제한은 기본값이 무제한으로 바뀌었다. 여러 사용자가 모델을 호출하는 환경이라면 업데이트 후 관리자 설정을 확인하고 사용량에 맞는 제한을 정하는 것이 좋다.

프로젝트는 이번 릴리스에 보안 수정이 포함됐다고 밝혔다. 다만 릴리스 노트에는 상세 내용이 없으며 CVE가 할당된 뒤 공지를 게시할 예정이라고 설명한다. 이 글은 공식 릴리스와 문서를 바탕으로 작성했으며 새 기능과 업그레이드 절차를 별도 환경에서 직접 실행하지는 않았다.

Discussion

No comments yet