🖥️ 데스크톱 앱

Libre WebUI 데스크톱 앱은 macOS, Windows, Linux에서 웹 인터페이스를 네이티브 창으로 제공합니다. 같은 컴퓨터에서 실행되는 서버 또는 지정한 모든 Libre WebUI 서버에 연결됩니다.

앱은 별도 저장소에서 개발됩니다. 각 릴리스의 설치 프로그램은 메인 저장소의 GitHub 릴리스에 첨부됩니다.

📦 다운로드 및 설치

최신 릴리스에서 플랫폼에 맞는 패키지를 받으세요.

macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg 또는 .zip, 또는 brew install --cask libre-webui/tap/libre-webui-desktop
Windows: Libre-WebUI-Desktop-Setup-{version}.exe(설치 프로그램) 또는 Libre-WebUI-Desktop-{version}.exe(포터블)
Linux: Libre-WebUI-Desktop-{version}.AppImage 또는 Libre-WebUI-Desktop-{version}-{arch}.deb

이름 변경 전 릴리스는 Libre-WebUI-Frontend 접두사와 Libre WebUI Frontend.app 앱 번들 이름으로 제공되었습니다.

macOS에서 앱이 손상되었다고 차단하는 경우

현재 Libre WebUI의 macOS 빌드는 임시로 ad-hoc 서명을 사용합니다. 애플리케이션 번들의 구조는 유효하지만 Apple에 게시자를 식별하지 못해 공증할 수 없습니다. 애플리케이션을 Applications로 복사한 뒤 시스템 설정 → 개인정보 보호 및 보안 → 그래도 열기에서 승인하세요.

macOS가 해당 옵션을 표시하지 않으면 애플리케이션이 공식 Libre WebUI 릴리스에서 왔는지 확인한 후에만 격리 속성을 제거하세요.

xattr -dr com.apple.quarantine "/Applications/Libre WebUI Desktop.app"
open "/Applications/Libre WebUI Desktop.app"

Gatekeeper를 전체적으로 비활성화하지 마세요. 원활한 배포에는 여전히 Developer ID Application 인증서와 Apple 공증이 필요합니다.

🔌 서버 연결

앱은 클라이언트이므로 Libre WebUI 서버가 필요합니다. 처음 실행하면 시작 화면에서 두 가지 경로를 제공합니다.

로컬: 컴퓨터의 서버를 탐색합니다(포트 3001, Docker 이미지와 npx libre-webui의 기본값). 상태 확인에 응답하면 연결합니다.
원격: 홈랩 또는 팀 배포처럼 도달 가능한 Libre WebUI 서버의 URL을 입력합니다. 연결 전에 앱이 검증합니다.

선택 사항은 저장됩니다. 나중에 서버를 바꾸려면 메뉴 막대에서 **Libre WebUI → 서버 전환…**을 사용하세요. 저장된 서버가 응답을 멈추면 빈 창 대신 시작 화면으로 돌아갑니다.

로컬 서버 실행 방법은 빠른 시작을 참조하세요. Docker Compose, npx libre-webui, Homebrew를 모두 사용할 수 있습니다.