════════════════════════════════════════════════════════════════════
CHANDRA & SONS PHARMA — cPANEL DEPLOYMENT GUIDE
Laravel 10 + Filament PHP CMS
════════════════════════════════════════════════════════════════════
OPTION A — WEB INSTALLER (Easiest) ──────────────────────────────
1. In cPanel → File Manager, upload chandrasons.zip to your
domain's root folder (e.g. public_html/)
2. Right-click the zip → Extract
3. Open your browser: https://yourdomain.com/install.php
4. Fill in your database credentials and admin password → Install
5. DELETE install.php from the server immediately after!
Done. Visit https://yourdomain.com/admin to log in.
OPTION B — MANUAL (SSH / cPanel Terminal) ──────────────────────
Step 1 — Upload & Extract
Upload chandrasons.zip into your hosting root folder
Unzip: unzip chandrasons.zip
Step 2 — Configure .env
cp .env.example .env
Edit .env with your actual DB credentials and APP_URL
Step 3 — Set Permissions
chmod -R 775 storage bootstrap/cache
chmod -R 664 storage/framework storage/logs
find storage -type f -exec chmod 664 {} \;
find storage -type d -exec chmod 775 {} \;
Step 4 — Run Setup Commands (cPanel Terminal)
php artisan key:generate
php artisan migrate --force
php artisan db:seed --force
php artisan storage:link
php artisan config:cache
php artisan route:cache
php artisan view:clear
Step 5 — Set Document Root (if needed)
In cPanel → Domains → your domain → Document Root
Point to: /home/yourusername/public_html/public
(Or use the root .htaccess already included — it redirects
web traffic into /public automatically)
Step 6 — Cron Job (cPanel → Cron Jobs)
Command: php /home/yourusername/public_html/artisan schedule:run
Frequency: Every Minute (*/1 * * * *)
AFTER INSTALLATION ──────────────────────────────────────────────
Admin URL: https://yourdomain.com/admin
Admin Email: admin@chandrasons.com (change in .env before seeding)
Admin Password: Admin@1234 (change immediately after login!)
Things to configure in Admin Panel:
Settings → General : Logo, phone, address, business hours
Settings → SEO : Google Analytics, Search Console verification
Settings → Email : SMTP host/port/password for enquiry emails
Brand Partners : Upload real company logos
Hero Banners : Upload store/warehouse photos
Products : Add your product catalog
FILE PERMISSIONS REFERENCE ─────────────────────────────────────
Directories: 755 (public) or 775 (writable dirs)
Files: 644 (public) or 664 (writable files)
Writable directories (must be 775):
storage/
storage/app/
storage/app/public/
storage/framework/
storage/framework/cache/
storage/framework/sessions/
storage/framework/views/
storage/logs/
bootstrap/cache/
DEFAULT ADMIN CREDENTIALS ──────────────────────────────────────
Email: admin@chandrasons.com
Password: Admin@1234
⚠️ CHANGE THIS IMMEDIATELY after first login!
Admin → profile icon (top right) → Edit Profile → Change Password
SEEDED DATA (installed automatically) ─────────────────────────
✅ 3 Languages: English, Hindi, Nepali
✅ All Site Settings (phone, address, social links, email config)
✅ 4 Services (Wholesale, Retail, Nepal Export, Pharmacy/Hospital)
✅ 4 Product Categories (Branded, Generic, Surgical, OTC)
✅ 30 Brand Partners with logos
✅ 10 FAQs (General + Nepal Export category)
✅ 3 Sample Testimonials
✅ 2 Sample Blog Posts
✅ Social Links (Facebook, Instagram, TikTok)
✅ Stats Counter (150+ Brands, 10+ Years, 1000+ Products, 2500+ Clients)
✅ Admin User
TROUBLESHOOTING ────────────────────────────────────────────────
White page / 500 error:
→ Check storage/ and bootstrap/cache/ are writable (chmod 775)
→ Check .env has correct DB credentials
→ Run: php artisan config:clear && php artisan view:clear
"Class not found" errors:
→ vendor/ directory must be present (it's included in the zip)
→ Run: composer dump-autoload
Images not showing:
→ Run: php artisan storage:link
→ Or create manually: ln -s ../storage/app/public public/storage
Session errors:
→ Ensure storage/framework/sessions/ exists and is writable
════════════════════════════════════════════════════════════════════