Mulai Cepat
Persyaratan
| Komponen | Minimum | Disarankan |
|---|---|---|
| Node.js | 22.22+ | LTS terbaru |
| RAM | 8 GB | 16 GB+ |
| Disk | 5 GB | 20 GB+ untuk model |
| GPU | Opsional | 8 GB+ VRAM untuk inferensi lokal cepat |
| Docker | Opsional | Wajib untuk tugas Work |
Libre WebUI bekerja dengan Ollama yang hanya memakai CPU, tetapi model kecil lebih cocok untuk CPU. Plugin penyedia awan hanya memerlukan kunci API terkait.
Chat, dokumen, artefak, dan fitur berbasis penyedia tidak memerlukan Docker. Work memerlukannya: Docker harus terpasang di komputer yang menjalankan backend Libre WebUI dan proses backend harus diizinkan memanggilnya. Perintah npx libre-webui tidak memasang Docker. Jika Docker tidak tersedia, bagian Libre WebUI lainnya tetap berjalan sementara Work melaporkan Runtime unavailable; perintah model tidak pernah dijalankan langsung di host sebagai jalan keluar.
Menjalankan Libre WebUI
npx libre-webui@latest
Buka http://localhost:8080. Buat akun pertama; akun itu menjadi administrator. Pendaftaran publik berikutnya tetap nonaktif kecuali Anda secara eksplisit menetapkan ENABLE_SIGNUP=true.
Peluncur paket menyimpan status persisten di ~/.libre-webui. Tetapkan DATA_DIR absolut untuk lokasi lain; nilai relatif diselesaikan dari direktori tempat Anda menjalankan npx.
Memasang Ollama
Pasang Ollama, lalu unduh model umum yang kecil:
ollama pull gemma4:12b
Pilihan lain yang kuat ialah gemma4:26b (MoE), gemma4:31b (dense), dan qwen3.8:27b. Gunakan Model Manager di Libre WebUI untuk melihat model terpasang, mencari Ollama Library terbaru, dan mengunduh model tanpa meninggalkan aplikasi.
Untuk pencarian dokumen semantik, pasang juga model embedding:
ollama pull nomic-embed-text
Menambahkan Penyedia Awan
Penyedia awan bersifat opsional. Tambahkan kunci per pengguna di Settings → API keys atau untuk seluruh server di backend/.env (kemudian mulai ulang backend), lalu aktifkan penyedia di Settings:
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GROQ_API_KEY=gsk_...
GEMINI_API_KEY=...
OPENROUTER_API_KEY=sk-or-...
KIMI_API_KEY=...
Aplikasi menyegarkan daftar model penyedia jika didukung. Anda tidak perlu membiarkan dokumentasi terbuka untuk menemukan nama model terbaru.
Memulai Tugas Work Pertama
Work memberi setiap tugas percakapan persisten dan sistem berkas terpisah berbasis kontainer. Fitur ini tersedia bagi administrator terautentikasi.
- Pasang dan jalankan Docker di komputer backend Libre WebUI.
- Mulai tugas dari tombol Work di kepala bilah samping, menu
+bilah tab, halaman Home, atauCmd/Ctrl + Shift + U. - Pilih model yang mendukung pemanggilan alat.
- Jelaskan apa yang ingin dibuat atau diubah, lalu pilih Run.
- Pantau hasil di tab Files, Activity, Git, Terminal, dan Preview pada panel ruang kerja.
Tugas tetap berada di bilah samping sehingga Anda dapat kembali ke percakapan dan berkas yang sama. Menghentikan proses atau pratinjau mempertahankan ruang kerja. Menghapus tugas menghapus ruang kerjanya secara permanen.
Work dapat memakai model Ollama terpasang, model Ollama Cloud, atau plugin penyedia chat/completion yang dikonfigurasi. Saat memilih penyedia jarak jauh, Libre WebUI menampilkan pemberitahuan: penyedia menerima percakapan, definisi alat, dan hasil alat yang diminta model. Proses otonom dapat melakukan beberapa panggilan penyedia berbayar.
Lihat Work: Ruang Kerja Terisolasi untuk batas runtime, persistensi, jaringan, pratinjau, dan keamanan.
Docker
git clone https://github.com/libre-webui/libre-webui
cd libre-webui
docker compose up -d
Buat administrator pertama di peramban. Tidak diperlukan tanda pendaftaran atau mulai ulang; pendaftaran publik berikutnya tertutup secara bawaan.
Jika Ollama sudah berjalan di host atau komputer lain:
docker compose -f docker-compose.external-ollama.yml up -d
Untuk akselerasi GPU NVIDIA, gunakan berkas Compose GPU dari repositori.
Berkas Compose repositori memasang soket Docker host sehingga Work tersedia saat Docker terpasang. Hal ini memberi aplikasi kendali setara root atas host; baca Work: Ruang Kerja Terisolasi terlebih dahulu. Di Linux, tetapkan DOCKER_GID dalam .env ke grup pemilik soket. Hapus pemasangan jika Work tidak diperlukan.
Ollama paket juga hanya tersedia secara internal. Tambahkan -f docker-compose.ollama-host.yml hanya jika proses host lain memerlukan API; penimpaan mengikat ke loopback secara bawaan.
Mengenali Aplikasi
Tab Home memiliki tiga bagian: Start (chat baru, chat incognito, tugas Work baru), Continue (percakapan dan tugas terbaru), serta Explore (Notes, Calendar, Automations, Models, Personas, Imagine). Tujuan yang sama ada di baris navigasi bilah samping dan palet perintah (Cmd/Ctrl + K) yang mencari chat, tugas Work, tindakan aplikasi, pesan, catatan, dan dokumen.
- Kalender — kalender per pengguna dengan acara berulang.
- Otomasi — proses AI terjadwal yang dikirim sebagai sesi chat.
Pintasan Papan Ketik
| Pintasan | Tindakan |
|---|---|
Cmd/Ctrl + K | Palet perintah (berfungsi saat mengetik) |
Cmd/Ctrl + Shift + O | Chat baru |
Cmd/Ctrl + Shift + U | Tugas Work baru |
Cmd/Ctrl + B | Aktif/nonaktif bilah samping |
Cmd/Ctrl + , | Settings |
Cmd/Ctrl + D | Ganti tema |
? | Buka Settings pada tab Shortcuts |
Esc | Tutup jendela pengaturan |
Enter | Kirim pesan |
Shift + Enter | Baris baru |