Lewati ke konten utama

🖥️ Aplikasi Desktop

Aplikasi desktop Libre WebUI membungkus antarmuka web dalam jendela native untuk macOS, Windows, dan Linux. Aplikasi ini terhubung ke server Libre WebUI: baik yang berjalan pada mesin yang sama maupun server apa pun yang Anda tentukan.

Aplikasi dikembangkan di repositori tersendiri; installer untuk setiap rilis dilampirkan pada rilis GitHub di repositori utama.

📦 Mengunduh dan Menginstal​

Ambil paket untuk platform Anda dari rilis terbaru:

  • macOS (Apple Silicon): Libre-WebUI-Desktop-{version}-mac-arm64.dmg atau .zip, atau brew install --cask libre-webui/tap/libre-webui-desktop
  • Windows: Libre-WebUI-Desktop-Setup-{version}.exe (installer) atau Libre-WebUI-Desktop-{version}.exe (portabel)
  • Linux: Libre-WebUI-Desktop-{version}.AppImage atau Libre-WebUI-Desktop-{version}-{arch}.deb

Rilis sebelum perubahan nama menyediakan aset tersebut dengan prefiks Libre-WebUI-Frontend dan bundel aplikasi bernama Libre WebUI Frontend.app.

macOS memblokir aplikasi karena dianggap rusak​

Libre WebUI untuk sementara menggunakan tanda tangan ad-hoc pada build macOS. Ini menjaga struktur bundel aplikasi tetap valid, tetapi tidak mengidentifikasi penerbit kepada Apple dan tidak dapat dinotariskan. Setelah menyalin aplikasi ke Applications, setujui melalui Pengaturan Sistem → Privasi & Keamanan → Tetap Buka.

Jika macOS tidak menawarkan opsi tersebut, hapus atribut karantina hanya setelah memastikan bahwa aplikasi berasal dari rilis resmi Libre WebUI:

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

Jangan menonaktifkan Gatekeeper secara global. Distribusi tanpa hambatan tetap memerlukan sertifikat Developer ID Application dan notarisasi Apple.

🔌 Menghubungkan ke Server​

Aplikasi ini adalah klien; aplikasi memerlukan server Libre WebUI. Pada peluncuran pertama, layar pembuka menawarkan dua jalur:

  • Lokal: aplikasi memeriksa server pada mesin Anda (port 3001, bawaan untuk image Docker dan npx libre-webui) lalu terhubung ketika pemeriksaan kesehatannya merespons.
  • Jarak jauh: masukkan URL server Libre WebUI mana pun yang dapat dijangkau, seperti homelab atau deployment tim. Aplikasi memverifikasinya sebelum terhubung.

Pilihan Anda diingat. Untuk mengganti server nanti, gunakan Libre WebUI → Ganti Server… di bilah menu. Jika server yang diingat berhenti merespons, aplikasi kembali ke layar pembuka alih-alih menampilkan jendela kosong.

Untuk menjalankan server lokal, lihat Mulai Cepat: Docker Compose, npx libre-webui, dan Homebrew semuanya dapat digunakan.

🧰 Work dalam Aplikasi Desktop​

Paket desktop tidak menyertakan backend, Docker, atau runtime kontainer Work. Ketersediaan Work ditentukan oleh server yang dihubunginya:

  • backend native yang dapat menjalankan docker info dapat membuat kontainer Work dan volume bernama yang dibatasi per tugas;
  • deployment Compose standar dari repositori menyediakan Work berbasis Docker dengan memasang soket Docker host, sedangkan deployment kontainer khusus tanpa runtime yang dapat dijangkau melaporkan Work tidak tersedia;
  • server Kubernetes menyediakan Work berbasis Pod/PVC saat chart Helm diinstal dengan work.enabled=true; dan
  • aplikasi tetap mendukung Chat saat Work tidak tersedia.

Berkas Work berada pada host Docker server atau penyimpanan Kubernetes, bukan di dalam aplikasi desktop. Pratinjau melewati proksi same-origin bertanda tangan milik Libre WebUI, sehingga klien desktop lokal maupun jarak jauh dapat menggunakannya ketika reverse proxy server mempertahankan lalu lintas HTTP dan WebSocket.

🎨 Integrasi Desktop​

  • Bilah menu native dengan menu aplikasi, edit, tampilan, jendela, dan bantuan
  • Bilah judul macOS khusus (hiddenInset) dengan tombol lampu lalu lintas di bilah samping
  • Mode gelap mengikuti preferensi sistem
  • Tautan eksternal dibuka di peramban bawaan Anda, tidak pernah di dalam aplikasi
  • Renderer berjalan dengan isolasi konteks dan tanpa integrasi Node

🚧 Batasan​

  • Arsitektur macOS: paket macOS saat ini hanya mendukung Apple Silicon (arm64)
  • Memerlukan server: aplikasi tidak menyertakan backend
  • Work bergantung pada runtime server: runtime Docker atau Kubernetes tidak disertakan
  • Tidak ada pembaruan otomatis: pembaruan memerlukan pengunduhan paket baru

Lihat Work: Ruang Kerja Terisolasi untuk detail keamanan runtime, penyedia, penyimpanan, dan pratinjau.