Deployment su Shared Hosting (cPanel)
Store Console è preferibile su un VPS (Docker o LEMP), ma funziona anche su un shared host performante. Con il shared hosting non è disponibile l'accesso root, viene solitamente usato MySQL anziché PostgreSQL, non sono disponibili Redis né processi a lunga esecuzione — questa pagina illustra esattamente cosa cambia.
Capacità minime dell'host
- PHP 8.4 con le estensioni standard di Laravel (la maggior parte dei selettori PHP di cPanel le include)
- MySQL 8.0+ o MariaDB 10.6+ (PostgreSQL, se disponibile, è preferito)
- Processi cron (almeno ogni minuto)
- L'accesso SSH è fortemente consigliato per
composereartisan
Passaggio 1: caricare l'app e impostare la Document Root
Carica ed estrai il tuo zip concesso in licenza al di fuori public_html, quindi imposta la Document Root del (sub)dominio sulla public/ directory dell'app da cPanel → Domains. Non esporre mai la root dell'applicazione.
Passaggio 2: configurare .env per il 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
Questi driver sono supportati nativamente: le tabelle di queue, cache e sessione sono incluse nelle migration predefinite, quindi non è necessario Redis.
Passaggio 3: migrazione e build
php artisan migrate --seed
npm run build # or build locally and upload public/build
Passaggio 4: voci cron (sostituiscono Horizon e systemd)
Aggiungi due processi cron in cPanel → Cron Jobs:
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
La seconda voce svuota tutte le queue ogni minuto ed esce, operazione sicura con i limiti di processo del shared hosting. Su shared hosting non vengono utilizzati Horizon e il relativo dashboard.
Che cosa peggiora — e come
- Funzionalità semantiche IA (ricerca vettoriale, embedding) richiedono PostgreSQL + pgvector — su MySQL vengono disattivate correttamente, mentre chat IA, generazione e strumenti per i report continuano a funzionare tramite il provider configurato
- Chat e notifiche in tempo reale utilizzano Reverb/WebSockets su un VPS — senza di esso, la UI ricade automaticamente sul polling periodico (
BROADCAST_CONNECTION=null) - Processi in background vengono eseguiti fino a un minuto dopo rispetto a un worker dedicato — un ritardo accettabile per posta, fatture e report; gli store con un carico elevato dovrebbero passare a un VPS
Quando passare a un VPS
Passa a un VPS quando attivi POS o il dispatch delle consegne (sensibile alla latenza), utilizzi la ricerca IA o elabori più di pochi ordini al minuto. I dati vengono migrati con un normale dump del database — non è necessario reinstallare nulla.

