• Tiếng Việt

      • Cài đặt ứng dụng NocoBase

      Nếu bạn chưa có ứng dụng NocoBase, cách nhanh nhất là cài @nocobase/cli trước, sau đó chạy nb init --ui một lần. Trong đa số trường hợp, cứ đi theo cấu hình mặc định của wizard là đủ.

      Điều kiện tiên quyết

      • Node.js >= 22
      • Yarn 1.x
      • Nếu bạn định cài bằng Docker, hãy chắc chắn Docker đã được khởi động trước

      Bước 1: Cài CLI

      Trước tiên, hãy cài NocoBase CLI ở mức toàn cục:

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

      Nếu bạn thường mở nhiều terminal cùng lúc hoặc muốn thao tác song song với AI Agents, bạn cũng nên chạy thêm nb session setup một lần. Làm vậy thì mỗi phiên sẽ giữ current env riêng, ít bị ảnh hưởng lẫn nhau hơn.

      Bước 2: Khởi tạo ứng dụng

      Theo mặc định, cách được khuyến nghị là mở thẳng wizard trực quan:

      nb init --ui

      2026-06-11-20-14-32

      Tùy theo đường đi setup bạn chọn, các bước hiện ra sẽ hơi khác nhau. Nhưng nếu đi theo nhánh mặc định Install a new app, thông thường bạn sẽ thấy 6 bước sau:

      1. Getting started - đặt identifier --env và chọn Install a new app
      2. App environment - thiết lập thông tin cơ bản của ứng dụng, vị trí lưu trữ và cổng runtime
      3. App source and version - chọn cách lấy ứng dụng cùng source và version sẽ dùng
      4. Configure the database - chọn cơ sở dữ liệu tích hợp sẵn hoặc cơ sở dữ liệu tùy chỉnh
      5. Create an admin account - thiết lập tài khoản quản trị đầu tiên
      6. Connection & authentication - nhập URL truy cập ứng dụng và chọn phương thức xác thực

      Nếu bạn quen thao tác trong terminal hơn, bạn cũng có thể chạy trực tiếp:

      nb init

      Nếu cần khởi tạo trong script hoặc CI, hãy dùng chế độ không tương tác:

      nb init --yes --env app1
      Cài đặt trên máy chủ từ xa

      Nếu bạn chạy nb init --ui trên server, nên đổi host mặc định sang IP hiện tại của server đó trước. Như vậy bạn mới có thể mở wizard từ trình duyệt trên máy local.

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

      Bước 3: Xác nhận ứng dụng đã sẵn sàng

      Sau khi cài xong, thông thường bạn nên kiểm tra trước 3 điều này:

      • Env đã được lưu thành công chưa
      • Ứng dụng đã khởi động bình thường chưa
      • Bạn có đăng nhập được bằng tài khoản quản trị hay không

      Các lệnh thường dùng là:

      nb env list
nb env info
nb app logs

      Với cài đặt local mặc định, thông thường bạn có thể mở trực tiếp http://localhost:13000 trên trình duyệt. Sau khi đăng nhập, mở phiên AI Agent mới hoặc khởi động lại phiên hiện tại là AI có thể bắt đầu làm việc với ứng dụng NocoBase này.

      Cấu hình CLI mặc định được lưu trong ~/.nocobase/, vì vậy AI Agents thường có thể truy cập từ bất kỳ thư mục làm việc nào.

      Nếu sau này ứng dụng này cần phục vụ người dùng thực tế, bạn không nên dùng trực tiếp IP + port trong thời gian dài. Bước tiếp theo thường là thêm reverse proxy và bật HTTPS.

      Liên kết liên quan