---
title: "Self-host Open WebUI: hubungkan model, kelola akun, dan simpan riwayat chat"
description: "Deploy Open WebUI dari template Zenavo, hubungkan API model yang kompatibel dengan OpenAI, daftarkan akun admin serta atur akses pengguna, lalu siapkan backup volume dan upgrade."
date: 2026-11-10
language: id-ID
url: https://zenavo.app/id-ID/blog/self-host-open-webui
---

# Self-host Open WebUI: hubungkan model, kelola akun, dan simpan riwayat chat

Jika Anda sudah punya API key dari berbagai penyedia model dan ingin punya halaman chat web sendiri untuk pribadi atau tim kecil, [Open WebUI](https://openwebui.com) adalah salah satu pilihan satu kontainer yang paling praktis: sudah dilengkapi akun multi-pengguna, riwayat percakapan, unggah dokumen, dan pergantian model.

Panduan ini memakai template Open WebUI di Zenavo untuk men-deploy antarmuka tersebut di server Anda sendiri lalu menghubungkannya ke API model eksternal. Jika Anda ingin membandingkannya dengan ruang kerja multi-pengguna yang menyertakan PostgreSQL, Redis, dan penyimpanan S3 terpisah, lihat juga [panduan LobeHub](https://zenavo.app/id-ID/blog/self-host-lobehub).

Template ini tidak menyertakan model lokal atau inferensi GPU; biaya server, platform Zenavo, dan API model hulu dihitung secara terpisah.

## Deploy Open WebUI

Pertama, [hubungkan server Linux](https://docs.zenavo.app/id-ID/servers/add-a-server) ke Zenavo, lalu buka [template Open WebUI](https://zenavo.app/deploy?template=open-webui), pilih server, dan deploy.

Pengaturan template saat ini:

| Pengaturan | Nilai atau fungsi |
|---|---|
| Image | `ghcr.io/open-webui/open-webui:main` |
| Port HTTP | `8080` |
| Volume | `/app/backend/data`: database SQLite, dokumen yang diunggah, dan pengaturan disimpan di sini |
| `WEBUI_SECRET_KEY` | Dibuat otomatis saat proyek dibuat, untuk mengamankan sesi login |
| `ENABLE_OLLAMA_API` | `false`, mematikan pengecekan Ollama lokal secara bawaan agar langsung memakai API eksternal |
| Variabel telemetri | `SCARF_NO_ANALYTICS`, `DO_NOT_TRACK`, dan `ANONYMIZED_TELEMETRY` dimatikan secara bawaan |
| Memori | Disarankan menyiapkan sekitar 2 GB |

Tag `main` mengikuti rilis terbaru dari hulu. Untuk pemakaian jangka panjang yang stabil, buka **Pengaturan → Sumber** pada layanan dan ubah image ke versi tetap yang sudah Anda uji (misalnya `ghcr.io/open-webui/open-webui:v0.6.5`).

## Pasang domain, lalu segera daftarkan akun admin

Di tab **Jaringan** pada layanan open-webui, pasang domain seperti `chat.example.com` ke port `8080`, tambahkan record DNS A yang mengarah ke server, lalu tunggu HTTPS aktif. Langkah-langkahnya ada di [Domain & HTTPS](https://docs.zenavo.app/id-ID/networking/domains).

**Segera buka situs dan daftarkan akun pertama begitu domain aktif.** Open WebUI menjadikan pendaftar pertama sebagai admin; sebelum Anda menyelesaikannya, siapa pun yang tahu alamat tersebut bisa mendaftar lebih dulu menjadi admin.

Setelah masuk, buka **Admin Panel → Settings → General** dan periksa kebijakan pendaftaran pengguna baru:

- Jika hanya untuk Anda sendiri: matikan pendaftaran pengguna baru (**Enable New Sign Ups**);
- Jika untuk tim: biarkan peran bawaan (**Default User Role**) di `pending` agar akun baru harus Anda setujui dulu sebelum bisa memakai model.

## Hubungkan API model

Buka **Admin Panel → Settings → Connections**, isi Base URL dan API Key dari penyedia model pada bagian OpenAI API, lalu simpan. Daftar model akan muncul di pemilih model di kiri atas halaman chat.

Dua cara yang umum dipakai:

- **Langsung ke penyedia resmi atau kompatibel**: masukkan alamat yang kompatibel dengan OpenAI dari penyedia (biasanya diakhiri `/v1` — pastikan `/v1` tidak tertulis dua kali) beserta API key-nya.
- **Lewat gateway buatan sendiri**: jika Anda sudah men-deploy [New API](https://zenavo.app/id-ID/blog/self-host-new-api), [Magpie](https://zenavo.app/id-ID/blog/self-host-magpie), atau [LiteLLM](https://zenavo.app/id-ID/blog/self-host-litellm), arahkan Base URL ke alamat gateway Anda untuk mengelola OpenAI, Anthropic, Gemini, dan DeepSeek dari satu tempat. Bila gateway berada di proyek Zenavo yang sama dengan Open WebUI, Anda bisa langsung memakai alamat jaringan privat (misalnya `http://new-api.zenavo.internal:3000/v1`).
- **Tambahkan pencarian web gratis dan bot aplikasi chat**: agar model dapat menelusuri halaman web terkini tanpa biaya per kueri, tambahkan [SearXNG](https://zenavo.app/id-ID/blog/self-host-searxng) di proyek yang sama; dan jika ingin memanggil asisten dari Telegram, Discord, atau Slack, padukan dengan [OpenClaw](https://zenavo.app/id-ID/blog/self-host-openclaw).

Jika dipakai bersama anggota tim lain, Anda bisa mengatur model mana saja yang boleh dilihat pengguna biasa lewat **Admin Panel → Settings → Models** agar model yang mahal tidak terpanggil tanpa sengaja.

## Backup dan upgrade

Akun, riwayat chat, file dokumen, dan pengaturan koneksi semuanya disimpan di volume `/app/backend/data`. Selain itu, variabel `WEBUI_SECRET_KEY` di tab **Variabel** layanan dipakai untuk melindungi sesi — **jangan mengubahnya setelah deploy**, dan simpan salinannya di pengelola kata sandi Anda.

Cadangkan volume dari tab **Backup & Pemulihan** pada layanan open-webui:

1. Pilih waktu pemeliharaan saat tidak ada yang memakai aplikasi, lalu hentikan proyek (backup volume mengharuskan proyek dalam keadaan berhenti).
2. Buat backup, lalu jalankan kembali proyek setelah selesai.
3. Unduh satu salinan backup untuk disimpan sendiri. File backup berisi riwayat percakapan dan API key yang tersimpan, jadi jaga kerahasiaannya.

Detail langkahnya ada di [Backup & Pemulihan](https://docs.zenavo.app/id-ID/operations/backups). Sebelum upgrade, cadangkan volume terlebih dahulu dan baca [catatan rilis](https://github.com/open-webui/open-webui/releases) Open WebUI sebelum mengganti tag image. Upgrade versi besar bisa memigrasikan struktur database internal, sehingga memulihkan backup sebelum upgrade adalah cara paling aman jika perlu kembali.

## Pertanyaan umum

**Daftar model kosong setelah menyimpan koneksi?**
Periksa apakah Base URL sudah diakhiri path yang diminta penyedia (sebagian besar API kompatibel OpenAI memerlukan `/v1`) dan apakah API key valid. Jika penyedia tidak menyediakan endpoint daftar model (`/v1/models`), ketik ID model secara manual di pengaturan koneksi.

**Muncul error 401 atau 404 saat memanggil model?**
401 biasanya berarti API key salah, kedaluwarsa, atau tidak punya izin ke model tersebut; 404 hampir selalu karena Base URL kelebihan `/chat/completions` atau kurang `/v1`.

**Sudah mengubah variabel lingkungan dan restart, tetapi pengaturan di halaman tidak berubah?**
Setelah Open WebUI menyimpan pengaturan admin ke dalam database-nya, nilai di database lebih diprioritaskan daripada variabel lingkungan. Ubah langsung lewat **Admin Panel → Settings** di web lalu simpan.

**Bisakah dihubungkan ke Ollama lokal?**
Bisa. Template mengatur `ENABLE_OLLAMA_API=false` secara bawaan agar log tidak terus menampilkan error saat Ollama tidak dipasang. Jika Anda menjalankan Ollama di proyek atau jaringan privat yang sama, ubah `ENABLE_OLLAMA_API` menjadi `true` dan isi `OLLAMA_BASE_URL`.

Mulailah dari [template Open WebUI](https://zenavo.app/deploy?template=open-webui): pasang domain, daftarkan akun admin lebih dulu dan batasi pendaftaran, lalu hubungkan API model serta jadwalkan backup volume.