Cần tư vấn ERP?

Liên hệ với chuyên gia của chúng tôi để được tư vấn miễn phí về giải pháp ERP phù hợp.

Tư vấn ngay
Cài đặt trên Docker cho phiên bản 0.0.4 trở xuống
Tài liệu cài đặt - 0.0.3 đến 0.0.4

Cài đặt trên Docker cho phiên bản 0.0.4 trở xuống

avatar
Admin
Admin
2026-01-11 14:01
30 lượt xem

🚀 Hướng dẫn cài đặt LiteERP trên Docker (Chi tiết & Chuẩn Production)

📌 Phần 1: Giới thiệu về LiteERP

LiteERP là một hệ thống ERP mã nguồn mở nhẹ (Lightweight ERP) được thiết kế dành cho doanh nghiệp nhỏ và vừa (SME). Khác với các nền tảng ERP truyền thống như Odoo hay SAP, LiteERP tập trung vào lõi hệ thống gọn nhẹ, dễ mở rộng thông qua extension, giúp doanh nghiệp chủ động phát triển theo đúng nhu cầu thực tế.

🔍 Vì sao nên chọn LiteERP?

  • Thuần lõi – Dễ mở rộng
    Core nhỏ gọn, dễ hiểu, toàn bộ nghiệp vụ nâng cao được triển khai qua extension.

  • Công nghệ hiện đại
    Backend sử dụng Laravel (PHP), frontend ReactJS, database MySQL 8.

  • Kiến trúc chuẩn doanh nghiệp
    Áp dụng Clean Architecture và Domain-Driven Design (DDD), dễ bảo trì, dễ scale.

  • Tối ưu cho SME
    Dễ cài đặt, dễ vận hành, có thể self-host, không yêu cầu hạ tầng phức tạp.

📌 Các tính năng chính

  • Quản lý sản phẩm, kho, khách hàng, đơn hàng, hóa đơn

  • Hệ thống role / permission, hỗ trợ multi-company

  • JWT Authentication, event-driven, hỗ trợ extension

  • Không phải phần mềm kế toán hay hóa đơn thuế – tập trung nghiệp vụ vận hành

⚙️ Phần 2: Hướng dẫn cài đặt LiteERP trên Docker

📌 1. Yêu cầu hệ thống

Đảm bảo máy của bạn đã cài:

  • Docker & Docker Compose

  • PHP >= 8.3

  • MySQL >= 8

  • Tối thiểu 4GB RAM (khuyến nghị cho build ban đầu & extension)

📌 2. Build & khởi động container

Tại thư mục gốc của project (chứa docker-compose.yml):

 
docker compose build && docker compose up -d

📌 3. Truy cập container backend

 
docker exec -it erpsoft-8.3 bash

📌 4. Cài đặt ứng dụng Laravel

Thực hiện lần lượt trong container:

 
composer install
cp .env.example .env
php artisan key:generate 
php artisan migrate
php artisan storage:link

📌 5. Phân quyền thư mục cần thiết

 
chmod -R 777 ./storage
chmod -R 777 ./extensions

📌 6. Tạo khóa JWT Authentication

 
php artisan jwt:generate-keys

📌 7. Tạo tài khoản quản trị (Admin)

 
php artisan app:create-admin {email} {password} {name}

Ví dụ:

 
php artisan app:create-admin admin@demo.com 123456 Admin

📌 8. Build frontend (React)

Thoát container (nếu cần), tại thư mục frontend:

 
npm run dev

Hoặc build production:

 
npm run build

📌 9. Truy cập hệ thống LiteERP

Mở trình duyệt và truy cập:

 
http://localhost:8001/dashboard/login

📌 10. Cấu hình SMTP Mail & Pusher trong file .env

📧 10.1 Cấu hình SMTP Mail

Mở file .env và thêm:

 
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your_email@gmail.com
MAIL_PASSWORD=your_app_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=your_email@gmail.com
MAIL_FROM_NAME="LiteERP"

🔹 Lưu ý

  • Gmail bắt buộc dùng App Password

  • Có thể dùng Zoho, Outlook, mail server riêng bằng cách đổi MAIL_HOST & PORT

Sau khi cấu hình:

 
php artisan config:clear
php artisan cache:clear

🚀 10.2 Cấu hình Pusher (Realtime / Broadcast)

Bước 1: Tạo app Pusher

👉 https://dashboard.pusher.com
Lấy các thông tin: APP_ID, KEY, SECRET, CLUSTER

Bước 2: Cấu hình .env

 
BROADCAST_CONNECTION=pusher
PUSHER_APP_ID=your_app_id
PUSHER_APP_KEY=your_app_key
PUSHER_APP_SECRET=your_app_secret
PUSHER_APP_CLUSTER=ap1
PUSHER_HOST=
PUSHER_PORT=443
PUSHER_SCHEME=https
PUSHER_APP_ENCRYPTED=true

⚙️ 11. Tuỳ chỉnh hệ thống (khuyến nghị)

 
APP_TIMEZONE="Asia/Ho_Chi_Minh"
APP_CURRENCY="VND"
APP_CURRENCY_LOCALE="vi-VN"

🔁 12. Chạy Queue & Schedule

⚠️ Bắt buộc khi dùng mail, notification, pusher, workflow

 
php artisan queue:work --queue=low,default,high
 
php artisan schedule:work

👉 Trong production, nên chạy bằng Supervisor.