VotersAlert cPanel 2-click Installer

Deploy the TanStack Start frontend and Laravel 12 backend on cPanel with env sync, pre-flight validation, automated builds, and cron-ready worker commands.

Validation required

Step 1: Configuration & Validation

cPanel routing

cPanel userApplication rootRepository root, usually /home/USER/votersalert.Frontend APP_URLTanStack Start Node.js app domain, e.g. https://app.example.com.Laravel APP_URLAPI domain served by Apache/PHP, e.g. https://api.example.com.API document rootMust be the backend/public directory.cPanel Node startup fileUse server.cpanel.mjs if cPanel rejects .output/server/index.mjs.

Database

DB_HOSTDB_PORTDB_NAME / DB_DATABASEDB_USER / DB_USERNAMEDB_PASSWORDDB_POOL_LIMIT

Runtime binaries

PHP binaryPrefer /opt/cpanel/ea-php84/root/usr/bin/php.Node.js binaryMust be Node 22+.Bun binaryOften /home/USER/.bun/bin/bun.Composer binary

Frontend auth

AUTH_ACCESS_SECRETAUTH_REFRESH_SECRETAUTH_ACCESS_TTL_SECONDSAUTH_REFRESH_TTL_SECONDSAUTH_MFA_TICKET_TTL_SECONDSAUTH_ISSUERAUTH_AUDIENCEAUTH_COOKIE_DOMAINAUTH_SECURE_COOKIES

Backend API keys

APP_KEY (blank lets artisan generate)PAYSTACK_PUBLIC_KEYPAYSTACK_SECRET_KEYFLUTTERWAVE_PUBLIC_KEYFLUTTERWAVE_SECRET_KEYFLUTTERWAVE_SECRET_HASHWHATSAPP_PHONE_NUMBER_IDWHATSAPP_ACCESS_TOKENWHATSAPP_WEBHOOK_VERIFY_TOKEN

Optional provider keys

WHATSAPP_BSP_BASE_URLWHATSAPP_BSP_TOKENSMS_PROVIDER_BASE_URLSMS_PROVIDER_TOKENVOICE_PROVIDER_BASE_URLVOICE_PROVIDER_TOKENVOICE_CALLER_IDMETA_GRAPH_VERSIONMETA_AD_ACCOUNT_IDMETA_ACCESS_TOKENGOOGLE_ADS_API_BASE_URLGOOGLE_ADS_CUSTOMER_IDGOOGLE_ADS_DEVELOPER_TOKEN

Billing, delivery, queue cron

Payment callback URLBilling currencyVAT basis pointsMinimum wallet funding koboCampaign dry runRequire paid invoiceCampaign queueCron queue namesQueue triesQueue timeoutDelivery batch sizeDelivery chunk sizeDelivery max attemptsWhatsApp delivery modeWhatsApp graph versionSMS sender ID

Pre-flight checks

Web PHP runtime
Detected 8.4.22; required 8.2.0+, preferred 8.4.0+.

Preferred PHP 8.4
PHP 8.4 is preferred on cPanel when available.

FAIL

Web PHP extensions
Missing: bcmath, curl, fileinfo, mbstring, pdo_mysql, zip

cPanel CLI PHP binary
Detected 8.4.22; binary: /opt/cpanel/ea-php84/root/usr/bin/php.

cPanel PHP path preference
Common cPanel PHP path is /opt/cpanel/ea-phpXX/root/usr/bin/php.

FAIL

CLI PHP extensions
Missing: bcmath, curl, fileinfo, mbstring, pdo_mysql, zip

Node.js for cPanel app
Detected v22.23.0; required v22+.

FAIL

Bun
Detected Unable to start command: bun --version; binary: bun.

FAIL

Composer
Unable to start command: composer --version

Repository root structure
Root must contain package.json and a Bun lockfile.

Laravel backend structure
backend/ must contain artisan and composer.json.

Backend public document root
cPanel API domain document root must be /home/votersalert/public_html/backend/public.

Laravel public .htaccess
backend/public/.htaccess routes Apache requests to index.php.

WARN

Current web document root
This request is served from /home/votersalert/public_html/deploy/installer; API domain should serve /home/votersalert/public_html/backend/public.

Environment files writable
Checks root .env and backend/.env permissions.

Laravel writable paths
storage/ and bootstrap/cache/ must be writable by the cPanel account.

FAIL

MySQL connectivity
Unable to connect with the configured database credentials.

cPanel follow-up

In Setup Node.js App, set application root to public_html and startup file to server.cpanel.mjs.
Add Node app env vars: NODE_ENV=production and NITRO_PRESET=node-server.
Restart the Node.js app after Step 2 completes.
In Domains, confirm the API domain document root is backend/public.

Cron job strings

Laravel scheduler

cd /home/votersalert/public_html/backend && /opt/cpanel/ea-php84/root/usr/bin/php artisan schedule:run >> /dev/null 2>&1

Queue worker fallback

cd /home/votersalert/public_html/backend && /opt/cpanel/ea-php84/root/usr/bin/php artisan queue:work database --queue=campaign-delivery,default --stop-when-empty --tries=3 --timeout=120 >> storage/logs/queue-cron.log 2>&1

Security note

Remove or password-protect this installer after deployment. It writes env files and runs server commands.