• Bahasa Indonesia

      • Instal aplikasi NocoBase

      Jika Anda belum memiliki aplikasi NocoBase, cara tercepat adalah memasang @nocobase/cli terlebih dahulu, lalu menjalankan nb init --ui sekali. Dalam kebanyakan kasus, konfigurasi default pada wizard sudah cukup.

      Prasyarat

      • Node.js >= 22
      • Yarn 1.x
      • Jika Anda berencana memasang dengan Docker, pastikan Docker sudah berjalan terlebih dahulu

      Langkah 1: Pasang CLI

      Pasang NocoBase CLI secara global terlebih dahulu:

      npm install -g @nocobase/cli
nb --version

      Jika Anda sering bekerja dengan beberapa terminal sekaligus atau ingin beroperasi paralel dengan AI Agents, kami juga menyarankan menjalankan nb session setup sekali. Dengan begitu, setiap sesi akan menyimpan current env miliknya sendiri, sehingga lebih kecil kemungkinan saling memengaruhi.

      Langkah 2: Inisialisasi aplikasi

      Rekomendasi defaultnya adalah langsung membuka wizard visual:

      nb init --ui

      2026-06-11-20-14-32

      Tergantung jalur setup yang Anda pilih, langkah yang muncul bisa sedikit berbeda. Jika Anda mengikuti jalur default Install a new app, biasanya Anda akan melihat enam langkah berikut:

      1. Getting started - tetapkan identifier --env dan pilih Install a new app
      2. App environment - atur informasi dasar aplikasi, lokasi penyimpanan, dan port runtime
      3. App source and version - pilih cara mendapatkan aplikasi serta source dan version yang akan digunakan
      4. Configure the database - pilih database bawaan atau database kustom
      5. Create an admin account - siapkan akun administrator pertama
      6. Connection & authentication - masukkan URL akses aplikasi dan pilih metode autentikasi

      Jika Anda lebih nyaman bekerja lewat terminal, Anda juga bisa langsung menjalankan:

      nb init

      Jika Anda perlu melakukan inisialisasi dalam script atau CI, gunakan mode non-interaktif:

      nb init --yes --env app1
      Instalasi di server remote

      Jika Anda menjalankan nb init --ui di server, kami menyarankan untuk mengubah default host ke IP server tersebut terlebih dahulu. Dengan begitu, Anda bisa membuka wizard dari browser lokal.

      nb config set default-ui-host <server-ip>
nb config set default-api-host <server-ip>

      Langkah 3: Pastikan aplikasi siap digunakan

      Setelah instalasi selesai, biasanya ada baiknya memastikan tiga hal ini terlebih dahulu:

      • Env sudah berhasil disimpan
      • Aplikasi sudah berjalan normal
      • Anda bisa login menggunakan akun administrator

      Perintah yang umum dipakai:

      nb env list
nb env info
nb app logs

      Untuk instalasi lokal dengan konfigurasi default, biasanya Anda bisa langsung membuka http://localhost:13000 di browser. Setelah login, buka sesi AI Agent baru atau restart sesi yang sedang berjalan, lalu AI bisa mulai bekerja dengan aplikasi NocoBase ini.

      Konfigurasi CLI secara default disimpan di ~/.nocobase/, sehingga AI Agents biasanya bisa mengaksesnya dari direktori kerja mana pun.

      Jika aplikasi ini nantinya akan dibuka untuk pengguna sungguhan, kami tidak menyarankan penggunaan jangka panjang dengan IP + port secara langsung. Langkah berikutnya biasanya adalah menambahkan reverse proxy dan mengaktifkan HTTPS.

      Tautan terkait