Shared Hosting(cPanel) 배포
Store Console은 VPS(Docker 또는 LEMP)를 권장하지만, 성능이 충분한 shared host에서도 실행됩니다. Shared hosting은 root 권한이 없고, 일반적으로 PostgreSQL 대신 MySQL을 사용하며, Redis와 장기 실행 프로세스를 사용할 수 없습니다. 이 페이지는 이에 따라 달라지는 사항을 정확히 설명합니다.
호스트의 최소 요구 기능
- PHP 8.4 및 표준 Laravel 확장 모듈(대부분의 cPanel PHP selector에 포함되어 있음)
- MySQL 8.0+ 또는 MariaDB 10.6+(가능한 경우 PostgreSQL 권장)
- Cron job(최소 1분마다 실행)
- SSH access는 다음에 대해 강력히 권장됨:
composer및artisan
1단계: 업로드 후 Document Root 설정
라이선스 zip 파일을 업로드하고 압축을 해제합니다 public_html, 이후 cPanel → Domains에서 (sub)domain의 document root를 앱의 public/ directory로 지정합니다. 애플리케이션 root 자체는 절대 노출하지 마세요.
2단계: Shared Hosting용 .env 설정
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
다음 driver가 기본으로 지원됩니다. queue, cache 및 session 테이블이 기본 migration에 포함되어 있으므로 Redis가 필요하지 않습니다.
3단계: Migration 및 Build
php artisan migrate --seed
npm run build # or build locally and upload public/build
4단계: Cron 항목(Horizon 및 systemd 대체)
cPanel → Cron Jobs에 cron job 두 개를 추가합니다.
* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55
두 번째 항목은 매분 모든 queue를 처리하고 종료합니다. Shared host의 프로세스 제한에서도 안전합니다. Shared hosting에서는 Horizon과 해당 dashboard를 사용하지 않습니다.
저하되는 기능 및 대응 방법
- AI 의미 기반 기능 (vector search, embeddings)은 PostgreSQL + pgvector가 필요합니다. MySQL에서는 해당 기능이 매끄럽게 비활성화되며, AI chat, generation 및 report 도구는 설정된 provider를 통해 계속 작동합니다.
- 실시간 chat 및 notification 은 VPS에서 Reverb/WebSockets를 사용합니다. 해당 기능이 없으면 UI가 자동으로 주기적 polling으로 전환됩니다("
BROADCAST_CONNECTION=null) - Background job 은 전용 worker에서보다 최대 1분 늦게 실행될 수 있으며, mail, invoice 및 report에는 문제가 없습니다. 규모가 큰 store는 VPS로 이전하는 것이 좋습니다.
VPS로 업그레이드하는 경우
POS 또는 Delivery dispatch를 활성화하거나(latency-sensitive), AI search에 의존하거나, 분당 몇 건을 넘는 order를 처리할 경우 VPS로 이전하세요. 데이터는 표준 database dump로 이전되므로 다시 설치할 필요가 없습니다.
마지막 수정: 11/19/2026

