Installation

CartUser installs in 5 minutes on any LAMP/LEMP stack. The browser-based wizard handles database migration and seeding automatically. No CLI required.

Before you start

Step 1 — Upload files

Option A — cPanel File Manager (easiest)

1. Log in to cPanel.
2. Open File Manager.
3. Navigate to public_html/ (or a subfolder if installing to subdomain).
4. Click Upload → choose your CartUser ZIP.
5. Wait for upload to complete.
6. Right-click the uploaded ZIP → Extract.
7. Move all contents (kode/, assets/, index.php, etc.) to the directory where you want CartUser to run.

Option B — FTP (FileZilla)

1. Unzip CartUser locally first.
2. Connect to your server via FTP.
3. Upload entire contents of the extracted folder to public_html/.
4. Wait for upload (5-15 min for ~50 MB).

Step 2 — Create database

1. Log in to cPanel → MySQL Databases (or phpMyAdmin → New).
2. Create a new database (e.g. cartuser). cPanel may prefix with your account name → account_cartuser.
3. Create a database user with a strong password.
4. Add the user to the database — grant ALL PRIVILEGES.
5. Note down: database name, username, password, host (usually localhost).

Step 3 — Run the installer

1. Open https://yourdomain.com/ in your browser.
2. CartUser auto-redirects to the install wizard.
3. Wizard screens:
   1. Welcome — system requirements check. All should be green.
   2. Envato verification — enter your purchase code + Envato username.
   3. Database setup — enter MySQL credentials from Step 2.
   4. Account setup — create SuperAdmin (username, email, password).
   5. Finished — redirect to admin login.
4. Log in to admin panel with the credentials you just created.

Step 4 — Set file permissions (Linux hosting)

If you have SSH access:

cd /home/user/public_html
chmod -R 755 .
chmod -R 775 kode/storage kode/bootstrap/cache
chmod 644 kode/.env

On shared hosting without SSH, use cPanel File Manager → right-click folder → Change Permissions:

• All files: 644
• All folders: 755
• kode/storage/ and kode/bootstrap/cache/: 775
• kode/.env: 644

Step 5 — Set up cron (for scheduled tasks)

Add this to cPanel → Cron Jobs (run every minute):

* * * * * cd /home/user/public_html/kode && php artisan schedule:run >> /dev/null 2>&1

This handles: payment notifications, low-stock alerts, expired coupon cleanup, recurring subscriptions, scheduled campaigns.

Step 6 — Verify installation

Optional — Load demo data

For showcase / testing, run the demo seeder from CLI:

cd /home/user/public_html/kode
php artisan db:seed --class=DemoProductSeeder --force

This adds:

• 6 categories with 22 sub-categories
• 24 physical products + 5 digital products
• 20 brands, 5 attributes
• 13 customers, 3 demo sellers
• 100+ orders spread across 12 months
• 8 active coupons, 3 flash sale campaigns
• Product reviews, wishlists, cart items, blog posts, FAQs

Demo credentials (password 123123):

• Customer: [email protected]
• Sellers: demoseller, fashionseller, homeseller

Installation troubleshooting

500 error after upload

Usually file permissions. Run:

chmod -R 775 kode/storage kode/bootstrap/cache

"Specified key was too long" during install

MySQL version too old (<5.7). Upgrade to MySQL 8.0+ or MariaDB 10.6+.

White page / blank screen

Enable debug mode in kode/.env:

APP_DEBUG=true

Reload page to see error. Set back to false after debugging.

"Class not found" or autoloader errors

SSH into server and run:

cd /home/user/public_html/kode
composer dump-autoload --no-dev --optimize

Database connection failed

Verify in kode/.env:

DB_HOST=localhost
DB_DATABASE=account_cartuser
DB_USERNAME=account_cartuser
DB_PASSWORD=...

cPanel always prefixes database/user with your account name.

Installer keeps redirecting to /install

Installation didn't complete. Delete the cache file:

rm kode/storage/cartuser_installed
php artisan cache:clear