Instalasi create-nocobase-app

Prasyarat
  • Sudah menginstal Node.js >= 22, Yarn 1.22.x
  • Sudah mengonfigurasi dan menjalankan database yang dibutuhkan: MySQL 8.0.17+, MariaDB 10.9+, atau PostgreSQL 10+
  • Karena keterbatasan jaringan di beberapa wilayah, disarankan untuk mengganti dengan registry mirror (opsional)
$ yarn config set disable-self-update-check true
$ yarn config set registry https://registry.npmmirror.com/

1. Membuat Proyek NocoBase

Pilih versi NocoBase (Perbandingan Versi) dan tipe database, lalu jalankan perintah yang sesuai.

Versi Latest
Versi Beta
Versi Alpha
PostgreSQL
MySQL
MariaDB
yarn create nocobase-app my-nocobase-app -d postgres \
   -e DB_HOST=localhost \
   -e DB_PORT=5432 \
   -e DB_DATABASE=nocobase \
   -e DB_USER=nocobase \
   -e DB_PASSWORD=nocobase \
   -e TZ=Asia/Shanghai
Penjelasan Variabel Lingkungan
  • TZ digunakan untuk mengatur zona waktu aplikasi, default adalah zona waktu sistem operasi
  • APP_KEY adalah kunci aplikasi, digunakan untuk menghasilkan Token pengguna dan lainnya (jika APP_KEY dimodifikasi, Token lama akan menjadi tidak valid). Bisa berupa string acak apa saja. Mohon ubah dengan kunci Anda sendiri dan pastikan tidak bocor ke pihak luar
  • DB_* adalah konfigurasi terkait database, mohon ubah sesuai dengan informasi koneksi database Anda

2. Pindah Direktori

cd my-nocobase-app

3. Instal Dependencies

📢 Karena pengaruh kondisi jaringan, konfigurasi sistem, dan faktor lainnya, langkah ini mungkin membutuhkan waktu beberapa belas menit.

yarn install
Tips Lingkungan Produksi

Saat deployment ke lingkungan produksi, untuk mengurangi ukuran, Anda dapat hanya menginstal dependensi yang diperlukan:

yarn install --production

4. Instal NocoBase

yarn nocobase install --lang=zh-CN

Proses instalasi akan secara otomatis membuat struktur tabel database dan menginisialisasi data.

5. Jalankan NocoBase

Lingkungan Pengembangan

yarn dev

Lingkungan Produksi

yarn start

6. Login ke NocoBase

Buka http://localhost:13000 di browser, akun dan password awal adalah admin@nocobase.com dan admin123.

Tips Keamanan Akun

Setelah login pertama kali, segera ubah password default untuk memastikan keamanan sistem.