Cara Pasang Dify di VPS untuk Membangun Aplikasi AI

Ingin membuat chatbot dari dokumen kantor, asisten balas pelanggan, atau alur AI bertahap tanpa menulis backend dari nol? Dify adalah platform open source untuk merakit aplikasi AI lewat antarmuka visual: kamu memilih model, menyambungkan basis pengetahuan, menyusun alur, lalu menerbitkannya sebagai web app atau API.

Kabar baiknya, Dify bisa dipasang sendiri di VPS dengan Docker Compose. Seluruh data percakapan dan dokumen tinggal di servermu, sementara model AI tetap bisa memakai API penyedia mana pun atau model lokal. Panduan ini mengikuti dokumentasi resmi Dify per 11 November 2026.

Apa saja yang perlu disiapkan sebelum memasang Dify?

Dokumentasi resmi menyebut kebutuhan minimum 2 core CPU dan 4 GiB RAM. Itu batas bawah untuk mencoba. Dify menjalankan beberapa container sekaligus (API, worker, web, database, Redis, vector database, sandbox, dan Nginx), jadi untuk dipakai tim sehari-hari, ruang RAM yang lebih longgar akan terasa lebih nyaman. Panduan umum memilih ukuran server ada di memilih spesifikasi VPS.

Perangkat lunak yang dibutuhkan:

• Docker dengan Docker Compose versi 2.35.0 atau lebih baru, dan daemon Docker dalam keadaan berjalan.
• Git untuk mengambil kode sumber.
• OpenSSL untuk membuat token acak.

Kalau Docker belum terpasang, ikuti dulu cara install Docker dan Docker Compose di Ubuntu. Setelah itu cek versinya:

docker compose version

Kalau versi yang muncul lebih lama dari 2.35.0, perbarui paket Docker Compose sebelum lanjut.

Langkah memasang Dify dengan Docker Compose

1. Pilih versi rilis

Buka halaman rilis Dify di GitHub dan catat tag versi terbaru yang stabil. Memasang dari tag tertentu (bukan cabang utama) membuat instalasi lebih mudah dilacak dan di-upgrade nanti.

2. Klon repositori

Ganti <versi> dengan tag yang kamu catat:

git clone --branch <versi> --depth 1 https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env

File .env berisi seluruh pengaturan: port, kata sandi database bawaan, penyimpanan file, dan lain-lain. Simpan salinannya, karena file ini juga perlu dicadangkan saat upgrade.

3. Buat token sandbox

Buat string acak:

openssl rand -hex 32

Buka .env dengan editor teks, cari variabel DIFY_AGENT_LOCAL_SANDBOX_AUTH_TOKEN, lalu isi dengan hasil perintah di atas. Nama variabel bisa berubah antar versi, jadi kalau tidak ketemu, baca bagian instalasi di dokumentasi untuk versi yang kamu pakai.

Selagi file terbuka, ganti juga nilai rahasia lain yang masih bawaan (misalnya kunci rahasia aplikasi dan kata sandi database) dengan nilai acak. Nilai bawaan dari contoh publik tidak cocok untuk server yang terhubung ke internet.

4. Jalankan semua layanan

docker compose up -d
docker compose ps --all

Tarik image pertama kali butuh beberapa menit, tergantung koneksi server. Layanan yang berjalan terus harus berstatus Up atau healthy. Tugas init_permissions memang selesai sendiri dan wajar berstatus Exited (0).

5. Buat akun administrator

Buka http://IP-SERVER/install dari browser. Isi email, nama, dan kata sandi admin. Setelah itu masuk lewat http://IP-SERVER. Port bawaannya 80.

Lakukan langkah ini secepatnya setelah container hidup. Selama halaman /install belum diisi, siapa pun yang membuka alamat itu lebih dulu bisa menjadi admin.

6. Sambungkan model AI

Masuk ke pengaturan Model Provider, pilih penyedia (OpenAI, Anthropic, Google, penyedia lain, atau model lokal seperti Ollama), lalu tempel API key. Tanpa langkah ini, aplikasi yang kamu buat belum bisa menjawab apa pun.

Bagaimana supaya Dify aman diakses dari internet?

Instalasi bawaan berjalan di HTTP polos. Untuk pemakaian sungguhan, beberapa hal sebaiknya dibereskan:

• Pakai domain dan HTTPS. Arahkan subdomain (misalnya ai.namausaha.com) ke IP VPS, lalu pasang sertifikat SSL. Kamu bisa memakai pengaturan HTTPS yang tersedia di .env Dify atau menaruh reverse proxy sendiri di depannya.
• Buka port seperlunya. Firewall cukup mengizinkan 22 (SSH), 80, dan 443. Port database dan Redis tidak perlu terbuka ke publik. Docker bisa melewati aturan firewall bila port dipetakan sembarangan, dan penjelasannya ada di mengamankan Docker agar port tidak bocor.
• Batasi pendaftaran. Undang anggota tim lewat menu anggota, bukan membiarkan siapa saja mendaftar.
• Lindungi API key. Kunci penyedia model disimpan di Dify, jadi akses admin sama berharganya dengan kunci itu sendiri.

Bagaimana cara upgrade Dify tanpa kehilangan data?

Data Dify tersimpan di folder docker/volumes/. Urutan dari dokumentasi resmi:

1. Dari folder dify/docker, jalankan docker compose stop.
2. Cadangkan docker/.env, file Compose yang kamu ubah, dan seluruh folder docker/volumes/.
3. Dari folder akar repositori, ambil versi baru:

git stash
git fetch --tags origin
git checkout <versi-baru>
git stash pop

4. Bandingkan .env.example yang baru dengan .env milikmu. Rilis baru kadang menambah variabel.
5. Dari dify/docker, jalankan docker compose pull, lalu docker compose up -d, dan cek dengan docker compose ps --all.

Jangan melompati langkah cadangan. Kalau migrasi database gagal di tengah jalan, salinan folder volumes adalah satu-satunya jalan pulang.

Ringkasan perintah penting

Setelah Dify jalan, coba mulai dari aplikasi sederhana: chatbot yang menjawab dari beberapa dokumen SOP. Konsep di baliknya, yaitu RAG, dibahas di chatbot AI dari dokumen perusahaan.

Checklist setelah pemasangan:

• Docker Compose minimal 2.35.0.
• Token sandbox dan nilai rahasia di .env sudah diganti.
• Akun admin dibuat lewat /install segera setelah container hidup.
• Domain dan HTTPS terpasang, port database tidak terbuka.
• Folder docker/volumes/ dan .env masuk jadwal backup.