Розгортання на Shared Hosting (cPanel)
Store Console рекомендує VPS (Docker або LEMP), але також працює на потужному shared host. Shared hosting означає відсутність root-доступу, зазвичай MySQL замість PostgreSQL, відсутність Redis і неможливість запускати тривалих процесів — ця сторінка описує саме ті зміни, які виникають.
Мінімальні можливості хостингу
- PHP 8.4 зі стандартними розширеннями Laravel (більшість cPanel PHP selectors містять їх)
- MySQL 8.0+ або MariaDB 10.6+ (PostgreSQL є кращим вибором, де доступний)
- Cron jobs (щонайменше раз на хвилину)
- SSH-доступ категорично рекомендований для
composerтаartisan
Крок 1: завантаження та налаштування Document Root
Завантажте й розпакуйте свій ліцензійний zip за межами public_html, а потім у cPanel → Domains налаштуйте document root (під)домену на public/ каталог застосунку. Ніколи не відкривайте публічний доступ до кореневого каталогу застосунку.
Крок 2: налаштування .env для 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
Ці драйвери є повноцінно підтримуваними: таблиці queue, cache і session включено до стандартних migrations, тому Redis не потрібен.
Крок 3: міграція та збірка
php artisan migrate --seed
npm run build # or build locally and upload public/build
Крок 4: записи Cron (замість Horizon і systemd)
Додайте два cron jobs у cPanel → Cron Jobs:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
Другий запис щохвилини обробляє всі черги й завершується, що безпечно враховуючи обмеження на кількість процесів на shared host. Horizon і його dashboard не використовуються на shared hosting.
Що погіршується — і як це обробляти
- AI-семантичні функції (vector search, embeddings) потребують PostgreSQL + pgvector — на MySQL вони коректно вимикаються, тоді як AI chat, генерація та інструменти report продовжують працювати через налаштованого provider
- Чат і сповіщення в реальному часі використовують Reverb/WebSockets на VPS — без них UI автоматично переходить на періодичний polling (
BROADCAST_CONNECTION=null) - Background jobs виконуються до хвилини пізніше, ніж на окремому worker — це прийнятно для mail, invoices і reports; для великих магазинів слід перейти на VPS
Коли переходити на VPS
Перейдіть на VPS, якщо ввімкнено POS або Delivery dispatch (чутливі до затримки), ви використовуєте AI search або обробляєте більше кількох orders за хвилину. Дані переносяться standard database dump — повторне встановлення не потрібне.

