Instalasi Source Code Git

Prasyarat

Sudah menginstal Git, 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. Download NocoBase ke Lokal

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

Versi Latest

Versi Beta

Versi Alpha

git clone https://github.com/nocobase/nocobase.git -b main --depth=1 my-nocobase

cd my-nocobase

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

yarn install --frozen-lockfile

Variabel lingkungan yang dibutuhkan NocoBase disimpan di file .env di direktori root, sesuaikan variabel lingkungan berdasarkan situasi aktual.

TZ=Asia/Shanghai
APP_KEY=your-secret-key
DB_HOST=localhost
DB_PORT=5432
DB_DATABASE=postgres
DB_USER=nocobase
DB_PASSWORD=nocobase

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, jika bukan layanan database default seperti contoh, sesuaikan berdasarkan situasi aktual.

yarn nocobase install --lang=zh-CN

Lingkungan Pengembangan

yarn dev

Lingkungan Produksi (Tidak Direkomendasikan)

Tidak disarankan untuk langsung men-deploy source code di lingkungan produksi. Untuk lingkungan produksi, lihat Deployment Lingkungan Produksi.

yarn build
yarn start

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.