Website & Admin Panel

Install on cPanel (shared hosting)

Shared hosting works for small-to-medium stores. The tricky part is pointing the domain at Laravel's public/ folder. This guide uses the cleanest approach.

1. Set the PHP version

In cPanel → Select PHP Version (or MultiPHP Manager), choose 8.3 and enable the extensions listed in Server Requirements.

2. Create the database

1. MySQL® Databases Create a database (e.g. user_bringo).
2. Create a user with a strong password.
3. Add the user to the database with All Privileges.

Note the final database name, user and password — you'll need them for .env.

3. Upload the files

Zip the bringo/ folder, upload it with cPanel File Manager (or FTP), and extract it above your web root — e.g. to /home/USER/bringo (not inside public_html).

Point the domain at /public

Choose whichever your host supports:

• Best: in Domains set the domain's Document Root to /home/USER/bringo/public.
• Alternative: move the contents of bringo/public into public_html, then edit public_html/index.php so the two require paths point up to /home/USER/bringo.

4. Make the app writable

In File Manager (or Terminal), make sure these folders are writable by PHP before the next step — Composer's post-install hook and the installer both need them.

First change into the folder you extracted the app to, then use paths relative to it. Every command on this page assumes you are inside that folder:

# examples — use YOUR actual path
cd ~/domains/your-domain.com/public_html/shop     # extracted inside public_html
# or
cd ~/bringo                                       # extracted above the web root

# confirm you are in the right place: this must list artisan and composer.json
ls artisan composer.json

chmod -R 775 storage bootstrap/cache

5. Install PHP dependencies

The package ships source only — no vendor/ folder — so this step is required. Open cPanel → Terminal and run:

composer install --no-dev --optimize-autoloader

ls /usr/bin/php8* /opt/alt/php8*/usr/bin/php 2>/dev/null

# CloudLinux / Hostinger layout — adjust to match your ls output
export PATH=/opt/alt/php84/usr/bin:$PATH

php -v      # confirm it changed
composer install --no-dev --optimize-autoloader

6. Create .env

Copy the template — this is required; the site cannot boot without a .env file:

cp .env.example .env

That's all. The app generates its own key on first request, and the install wizard (step 8) writes your database details and APP_URL into the file automatically. Only touch it later for advanced options — see the .env Reference. Make sure the file is writable — a read-only .env blocks both the auto-generated key and the wizard.

7. Build the frontend

The compiled assets are not in the package either, so this is also required. With Terminal + Node 20.19+ available:

npm ci
npm run build

which node npm
ls /opt/alt/alt-nodejs*/root/usr/bin/npm 2>/dev/null
export PATH=/opt/alt/alt-nodejs20/root/usr/bin:$PATH   # if one was found

8. Run the install wizard

php artisan storage:link

If storage:link is blocked, create the symlink in File Manager, or point public/storage at ../storage/app/public. Then open your domain in a browser — you are redirected to https://your-domain.com/install automatically. The wizard walks you through: requirements check → your Envato purchase code → the database details from step 2 → automatic data install → create your admin account → store setup. No SQL import, no manual .env editing — see Database Setup for what happens under the hood.

9. Cron job

cPanel → Cron Jobs, add a job that runs every minute:

# use YOUR app path and the SAME PHP binary you used for composer
* * * * * cd /home/USER/domains/YOURDOMAIN/public_html/shop && /opt/alt/php84/usr/bin/php artisan schedule:run >> storage/logs/cron.log 2>&1

See Cron & Queue Workers for the queue worker (important for notifications).

10. Cache & go

php artisan config:cache
php artisan route:cache