Triển khai shared hosting (cPanel)
Store Console thích hợp hơn với VPS (Docker hoặc LEMP), nhưng vẫn có thể chạy trên shared hosting đủ mạnh. Shared hosting không có quyền truy cập root, thường dùng MySQL thay vì PostgreSQL, không có Redis và không thể chạy các tiến trình lâu dài — trang này trình bày chính xác những điểm khác biệt.
Năng lực tối thiểu của máy chủ
- PHP 8.4 với các extension Laravel tiêu chuẩn (hầu hết trình chọn PHP của cPanel đều đã bao gồm)
- MySQL 8.0+ hoặc MariaDB 10.6+ (ưu tiên PostgreSQL nếu có)
- Cron jobs (tối thiểu mỗi phút một lần)
- Rất khuyến nghị có quyền truy cập SSH để
composervàartisan
Bước 1: Tải lên và trỏ Document Root
Tải lên và giải nén file zip đã được cấp phép bên ngoài public_html, sau đó trỏ document root của (sub)domain về thư mục ứng dụng trong public/ bằng cPanel → Domains. Không bao giờ đưa thư mục gốc của ứng dụng ra public.
Bước 2: Cấu hình .env cho shared hosting
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password
QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null
Các driver này đều được hỗ trợ đầy đủ: các bảng queue, cache và session đã có trong migrations mặc định, nên không cần Redis.
Bước 3: Migrate và build
php artisan migrate --seed
npm run build # or build locally and upload public/build
Bước 4: Cron entries (thay thế Horizon và systemd)
Thêm hai cron jobs trong cPanel → Cron Jobs:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
Cron entry thứ hai xử lý toàn bộ queue mỗi phút một lần rồi thoát, an toàn với giới hạn tiến trình của shared hosting. Horizon và dashboard của Horizon không được dùng trên shared hosting.
Những gì bị giảm chất lượng — và cách xử lý
- Tính năng AI ngữ nghĩa (vector search, embeddings) cần PostgreSQL + pgvector — trên MySQL, các tính năng này sẽ tự động tắt, trong khi AI chat, generation và report tools vẫn hoạt động qua provider đã cấu hình
- Chat và thông báo theo thời gian thực dùng Reverb/WebSockets trên VPS — nếu không có, UI sẽ tự động chuyển sang polling định kỳ ("
BROADCAST_CONNECTION=null) - Background jobs có thể chạy chậm hơn tối đa một phút so với khi dùng worker riêng — vẫn chấp nhận được cho mail, invoices và reports; các cửa hàng có lưu lượng lớn nên chuyển sang VPS
Khi nào nên nâng cấp lên VPS
Chuyển sang VPS khi bật POS hoặc Delivery dispatch (nhạy cảm về độ trễ), phụ thuộc vào AI search, hoặc xử lý hơn vài orders mỗi phút. Dữ liệu của bạn được migrate bằng database dump tiêu chuẩn — không cần cài đặt lại.

