👋 You're exploring a live Store Console demo — nothing here is real data

공용 호스팅(cPanel) 배포

Store Console은 VPS(Docker 또는 LEMP)를 권장하지만, 성능이 충분한 공용 호스팅에서도 실행됩니다. 공용 호스팅은 root 권한이 없고, 일반적으로 PostgreSQL 대신 MySQL을 사용하며, Redis와 장기 실행 프로세스를 사용할 수 없습니다. 이 페이지에서는 바로 이러한 차이점을 다룹니다.

호스트 최소 요구 사항

  • PHP 8.4 및 표준 Laravel 확장 기능(대부분의 cPanel PHP selector에 포함됨)
  • MySQL 8.0+ 또는 MariaDB 10.6+(사용 가능한 경우 PostgreSQL 권장)
  • Cron jobs(최소 1분마다 실행)
  • SSH 접근은 다음 기능을 위해 강력히 권장됩니다: composer 및 artisan

1단계: 업로드 후 Document Root 설정

라이선스(zip 파일)을 업로드하고 다음과 같은 외부 경로에 압축을 푸세요. public_html, 이후 cPanel → Domains에서 (sub)domain의 document root를 앱의 public/ directory로 지정하세요. 애플리케이션 root 자체는 절대 노출하지 마세요.

2단계: 공용 호스팅용 .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

다음 drivers는 기본 지원됩니다. queue, cache 및 session tables이 기본 migrations에 포함되어 있으므로 Redis가 필요하지 않습니다.

3단계: 마이그레이션 및 빌드

php artisan migrate --seed
npm run build   # or build locally and upload public/build

4단계: Cron entries(Horizon 및 systemd 대체)

cPanel → Cron Jobs에 두 개의 cron jobs를 추가하세요:

* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55

두 번째 entry는 매분 모든 queue를 처리한 뒤 종료됩니다. 이는 공용 호스팅의 process limits 내에서 안전하게 실행됩니다. 공유 호스팅에서는 Horizon과 해당 dashboard를 사용하지 않습니다.

제한되는 기능 및 대처 방법

  • AI semantic 기능 (vector search, embeddings)을 사용하려면 PostgreSQL + pgvector가 필요합니다. MySQL에서는 이 기능들이 매끄럽게 비활성화되며, AI chat, generation 및 report tools는 설정한 provider를 통해 계속 사용할 수 있습니다
  • 실시간 chat 및 notifications 는 VPS에서 Reverb/WebSockets를 사용합니다. 이를 사용하지 않으면 UI가 자동으로 주기적 polling으로 전환됩니다("BROADCAST_CONNECTION=null)
  • Background jobs 는 전용 worker를 사용하는 경우보다 최대 1분 늦게 실행됩니다. mail, invoices 및 reports에는 문제가 없지만, 트래픽이 많은 store는 VPS로 옮겨야 합니다

VPS로 업그레이드해야 하는 경우

POS 또는 Delivery dispatch를 활성화하거나(latency에 민감함), AI search에 의존하거나, 매분 소량의 order보다 많은 주문을 처리할 때는 VPS로 전환하세요. 데이터는 표준 database dump를 사용하여 마이그레이션할 수 있으므로 다시 설치할 필요가 없습니다.

마지막 수정: 11/20/2026