Skip to main content

Installation

LeadHub installs entirely through a browser-based wizard. No SSH, no terminal, no Composer.


Before You Beginโ€‹

โœ… Confirm your server meets the requirements
โœ… Create a MySQL database and database user (note the credentials)
โœ… Have your license key ready (from CodeCanyon purchase)
โœ… Have FTP/cPanel File Manager access to upload the files


Step 1 โ€” Upload the Filesโ€‹

  1. Download the LeadHub package from CodeCanyon โ†’ Downloads.
  2. Extract the ZIP file on your computer.
  3. Upload the entire contents of the extracted folder to your web root (e.g. public_html/) via FTP or cPanel File Manager.

โš ๏ธ Do not upload the outer folder itself โ€” upload its contents so that index.php sits directly in public_html/.


Step 2 โ€” Set File Permissionsโ€‹

On shared hosting these are usually set automatically, but verify:

PathPermission
storage/755 (recursively)
bootstrap/cache/755
public/755

Step 3 โ€” Open the Installation Wizardโ€‹

Navigate to your domain in a browser:

https://yourdomain.com/install

If you see a white page or error, check that mod_rewrite is enabled and .htaccess is present in the root.


Step 4 โ€” Requirements Checkโ€‹

The wizard checks all PHP requirements automatically. Any failing item is shown in red with a brief explanation. Fix any red items before proceeding.


Step 5 โ€” Database Configurationโ€‹

Enter your database credentials:

FieldDescription
Database HostUsually localhost or 127.0.0.1
Database PortUsually 3306
Database NameThe database you created
Database UsernameThe database user
Database PasswordThe database user's password

Click Test Connection to verify, then Next.


Step 6 โ€” Application Settingsโ€‹

FieldDescription
App URLYour domain, e.g. https://yourdomain.com
App NameShown in the browser tab and emails
TimezoneYour primary timezone

Step 7 โ€” License Keyโ€‹

Enter the Purchase Code (license key) from your CodeCanyon purchase. The wizard validates it online.


Step 8 โ€” Super Admin Accountโ€‹

Create the first super admin account:

FieldNotes
NameYour full name
EmailUsed to log in
PasswordMinimum 8 characters

โš ๏ธ Save these credentials โ€” this is the root admin account for the entire platform.


Step 9 โ€” Cron Job Setupโ€‹

The wizard shows the exact cron command for your server. Copy it and add it to your hosting control panel:

* * * * * /usr/bin/php /home/username/public_html/cron.php >> /dev/null 2>&1

On cPanel: Cron Jobs โ†’ Add New Cron Job โ†’ Every Minute โ†’ paste the command.


Step 10 โ€” Finishโ€‹

Click Complete Installation. The wizard writes the .env file and runs migrations. When done, you are redirected to the Super Admin login page at /super-admin.


After Installationโ€‹

  1. Log in at /super-admin with the credentials you just created.
  2. Create your first Tenant.
  3. Log in to the tenant admin panel at /admin (or tenant.yourdomain.com/admin).

Troubleshootingโ€‹

ProblemFix
Blank page at /installCheck .htaccess exists and mod_rewrite is on
"Database connection failed"Verify credentials; ensure the DB user has full privileges
Stuck at requirements checkInstall the missing PHP extension via cPanel โ†’ PHP Extensions
500 error after installCheck storage/logs/laravel.log via File Manager

โžก See also: Shared Hosting Guide