Black Friday sale최대 60% 할인
  • 연간 플랜 첫해 60% 할인
  • 평생 라이선스 45% 할인
종료까지
혜택 받기

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