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โ
- Download the LeadHub package from CodeCanyon โ Downloads.
- Extract the ZIP file on your computer.
- 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.phpsits directly inpublic_html/.
Step 2 โ Set File Permissionsโ
On shared hosting these are usually set automatically, but verify:
| Path | Permission |
|---|---|
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:
| Field | Description |
|---|---|
| Database Host | Usually localhost or 127.0.0.1 |
| Database Port | Usually 3306 |
| Database Name | The database you created |
| Database Username | The database user |
| Database Password | The database user's password |
Click Test Connection to verify, then Next.
Step 6 โ Application Settingsโ
| Field | Description |
|---|---|
| App URL | Your domain, e.g. https://yourdomain.com |
| App Name | Shown in the browser tab and emails |
| Timezone | Your 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:
| Field | Notes |
|---|---|
| Name | Your full name |
| Used to log in | |
| Password | Minimum 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โ
- Log in at
/super-adminwith the credentials you just created. - Create your first Tenant.
- Log in to the tenant admin panel at
/admin(ortenant.yourdomain.com/admin).
Troubleshootingโ
| Problem | Fix |
|---|---|
Blank page at /install | Check .htaccess exists and mod_rewrite is on |
| "Database connection failed" | Verify credentials; ensure the DB user has full privileges |
| Stuck at requirements check | Install the missing PHP extension via cPanel โ PHP Extensions |
| 500 error after install | Check storage/logs/laravel.log via File Manager |
โก See also: Shared Hosting Guide