Hướng dẫn cài đặt

Trang này hướng dẫn bạn cài đặt và chạy PROJECT_NAME_VI lần đầu tiên.

Yêu cầu hệ thống

Trước khi cài đặt, đảm bảo máy tính của bạn đáp ứng các yêu cầu sau:

Yêu cầu	Phiên bản tối thiểu
Hệ điều hành	Windows 10 / Ubuntu 20.04 / macOS 12
RAM	4 GB
Dung lượng ổ đĩa	10 GB trống

Các bước cài đặt

Bước 1: Tải phần mềm

Truy cập GITHUB_URL/releases và tải phiên bản mới nhất về máy.

Bước 2: Cài đặt

# Ví dụ lệnh cài đặt
npm install

Bước 3: Cấu hình ban đầu

Sao chép file cấu hình mẫu:

cp .env.example .env

Chỉnh sửa file .env theo môi trường của bạn:

APP_URL=http://localhost:3000
DB_HOST=localhost
DB_NAME=myapp
DB_USER=root
DB_PASS=password

Bước 4: Khởi động

npm start

Truy cập http://localhost:3000 để kiểm tra.

Xử lý lỗi thường gặp

Lỗi kết nối cơ sở dữ liệu

Kiểm tra lại thông tin DB_HOST, DB_USER, DB_PASS trong file .env.

Cổng đã được sử dụng

Thay đổi APP_PORT trong .env sang cổng khác, ví dụ 3001.

Bước tiếp theo

Sau khi cài đặt thành công, xem Cấu hình cơ bản để tinh chỉnh hệ thống.