Installation Wizard

LeadHub installs entirely through your web browser. There is no command line, no terminal, no SSH. You upload the files, open a URL, and follow five simple steps. This guide walks you through the entire process from start to finish.

Total time: approximately 10–20 minutes.

Before You Begin

Make sure your server meets the requirements listed in the Server Requirements guide. In particular, confirm that:

PHP 8.3 or higher is active for your domain
You have a MySQL database (or MariaDB) available — or you can create one (instructions below)
Your storage/ and bootstrap/cache/ directories are writable
You have around 500 MB of free disk space

Step 1 — Upload the LeadHub Files to Your Server

Download the package

After purchasing LeadHub, download the ZIP package from your purchase confirmation email or from the Envato Downloads page. The file will be named something like leadhub-v1.0.0.zip.

Inside the ZIP you will find everything LeadHub needs — including the vendor/ folder (all PHP dependencies), pre-compiled CSS and JavaScript, and the installer itself. You do not need to install anything separately.

Upload via cPanel File Manager (easiest method)

This is the recommended approach for most users on shared hosting.

Log in to your cPanel account.
Click File Manager in the Files section.
Navigate to the folder where you want to install LeadHub. This is typically:
- public_html/ if you want LeadHub at your main domain (e.g., https://yourdomain.com)
- A subdirectory like public_html/leadhub/ if you want it at a path
- A dedicated addon domain folder if you set up an addon domain (recommended — see Shared Hosting Guide for details)
Click Upload in the toolbar.
Upload the leadhub-v1.0.0.zip file.
After the upload finishes, go back to File Manager, right-click the ZIP file, and choose Extract.
Extract it into the correct folder.

Upload via FTP

If you prefer FTP (using a program like FileZilla or Cyberduck):

Connect to your server using your FTP credentials (host, username, password, port 21).
Navigate to the destination folder on your server (the right panel in FileZilla).
Drag the unzipped leadhub folder from your computer into the server folder.
Wait for all files to finish uploading. This may take 5–15 minutes depending on your connection speed — there are many files in the vendor/ directory.

Tip: It is faster to upload the ZIP file via File Manager and extract it on the server than to upload thousands of individual files over FTP.

Step 2 — Set File Permissions

LeadHub needs to be able to write to certain folders. "Permissions" are settings that control who is allowed to read, write, or run files. You need to set the following folders to permission level 755 (sometimes shown as rwxr-xr-x).

In cPanel File Manager:

Open File Manager and navigate to your LeadHub folder.
Right-click on the storage folder and choose Change Permissions.
Set it to 755 and make sure the "Recurse into subdirectories" checkbox is ticked.
Click Change Permissions.
Repeat this for the bootstrap/cache folder (set to 755).

That is all you need to do. The installer will also attempt to fix permissions automatically if it finds any issues.

Step 3 — Open the Installer in Your Browser

Open your web browser and visit:

https://yourdomain.com/install

Replace yourdomain.com with your actual domain name. If you installed LeadHub in a subdirectory, include that in the path (e.g., https://yourdomain.com/leadhub/install).

The installer will load and take you through five steps. Each step is a simple form — fill it in and click Next.

If you see a 404 "Page Not Found" error: Double-check that your files are in the right folder and that the public/.htaccess file was uploaded correctly. On cPanel, also confirm that mod_rewrite is enabled (it is enabled by default on virtually all shared hosts).

If you see a blank white page: PHP is probably not enabled for that folder, or the PHP version is too old. Go back to cPanel → MultiPHP Manager and confirm PHP 8.3 is selected for your domain.

Installer Step 1 — Welcome and Requirements Check

The first page of the installer is the Requirements Check. LeadHub automatically scans your server and shows you a checklist of everything it needs.

You will see green checkmarks next to the things that are working correctly and red warnings next to anything that needs attention. Here is what each section checks:

PHP Version — must be 8.3 or higher
PHP Extensions — checks all 13 required extensions (pdo, pdo_mysql, mbstring, openssl, tokenizer, xml, ctype, json, bcmath, fileinfo, curl, zip, gd)
Directory Permissions — checks that storage/ and bootstrap/cache/ are writable

What to do if something fails

PHP version too low: Go to cPanel → MultiPHP Manager → change your domain to PHP 8.3. Come back and refresh the installer page.

A PHP extension is missing: Go to cPanel → Select PHP Version → find the missing extension in the list → tick the checkbox → Save. Come back and refresh the installer page.

A directory is not writable: Go to cPanel → File Manager → right-click the storage or bootstrap/cache folder → Change Permissions → set to 755 and recurse into subdirectories. Come back and refresh.

Once everything shows a green checkmark, click the "Next: Database" button to proceed.

Installer Step 2 — Database Configuration

This step connects LeadHub to your MySQL database. You will need to fill in four fields:

Field	What to enter
Database Host	Usually `localhost` or `127.0.0.1` — leave as the default unless your host tells you otherwise
Port	Usually `3306` — this is the standard MySQL port. Leave it as-is.
Database Name	The name of the MySQL database you created (see below)
Database Username	The MySQL user you created (see below)
Database Password	The password for that MySQL user

After filling these in, the installer will test the connection immediately when you click "Next: Admin Account". If the connection fails, it will tell you on this page so you can correct the details.

How to create a MySQL database in cPanel

If you have not created a database yet, here is how to do it:

In cPanel, look for MySQL Databases (in the Databases section).
Under "Create New Database", type a name for your database (e.g., leadhub) and click Create Database. Note: cPanel will prefix your username to the database name automatically (e.g., myuser_leadhub). Make a note of the full name.
Scroll down to "MySQL Users" and under "Add New User", create a new username (e.g., leadhub_user) and a strong password. Click Create User. Make a note of this username and password.
Scroll down to "Add User to Database". Select the user you just created and the database you just created, then click Add.
A page will appear asking which permissions to grant. Tick "All Privileges" and click Make Changes.

You now have a database ready. Go back to the installer and fill in the database name (the full prefixed name, e.g., myuser_leadhub), username, and password.

Installer Step 3 — Admin Account

This step creates the first administrator account for LeadHub. Fill in:

Field	What to enter
Your Name	Your full name (e.g., "Jane Smith")
Email Address	Your email address — this will be your login username
Password	A strong password (at least 8 characters)
Confirm Password	Same password again
Workspace Name	The name of your organization or workspace

What is a Workspace?

A workspace is your organization's account within LeadHub. Everything in LeadHub — leads, pipelines, team members, automations — belongs to a workspace. When you first install LeadHub, one workspace is created automatically for you. You are set as its owner with full Super Admin permissions.

Think of a workspace like your company's account. The workspace name you enter here will appear throughout the admin panel (e.g., in the sidebar header, email footers, and reports).

Click "Next: License" when done.

Installer Step 4 — License

This step lets you enter your Envato purchase code to activate your license. This is the license key you receive when you purchase LeadHub on CodeCanyon (Envato Market).

To find your purchase code:

Log in to your Envato Market / CodeCanyon account.
Go to your profile → Downloads.
Find LeadHub in your list of purchases.
Click "Download" → "License certificate & purchase code".
Copy the purchase code (it looks like: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).

Paste it into the License Key field and click "Next: Finish".

You can also skip this step by leaving the field blank and clicking Next. LeadHub will install without a license. You can add your license key later in Settings → License from within the admin panel. Some features may be limited or display license reminders without an active license.

Installer Step 5 — Finish

This is the final step. You will see a summary of your configuration choices before installation begins. Click "Install LeadHub" to start.

The installer will now do the following — all automatically, with no input needed from you:

Write the configuration file (.env) — stores your database connection, app key (a random security code), and basic settings. Session driver is set to file by default, which works on all shared hosting.
Run database migrations — creates all the database tables that LeadHub needs (leads, users, pipelines, automations, etc.).
Seed the database — inserts the default roles (super admin, admin, manager, agent, viewer) and permissions.
Create your admin account — creates your account with the details you provided in Step 3, assigned the Super Admin role.
Create your workspace — sets up your workspace with you as the owner.
Link the storage folder — creates a link so uploaded files (logos, avatars, imports) are accessible from the browser.
Cache configuration — speeds up the application by caching settings.

This process takes approximately 30–90 seconds. You will see a progress indicator. When it is complete, you will see a success message and be automatically redirected to /admin where you can log in with the email and password you created in Step 3.

Installation is complete.

Post-Installation Checklist

After the wizard finishes and you are logged in, do these things immediately:

1. Set up the Cron Job (CRITICAL)

Without the cron job, your automations will not run, lead source webhooks will queue up unprocessed, and email notifications will not send.

The only cron job you need to add is:

php /home/yourusername/leadhub/cron.php >> /dev/null 2>&1

This should run every minute. See the Shared Hosting Guide for exact step-by-step instructions on adding this cron job in cPanel, Plesk, and DirectAdmin.

2. Configure Email

Go to Settings → Email in the admin panel. Enter your SMTP server details (host, port, username, password, encryption). Click "Send Test Email" to verify it works before relying on it. Without this step, no emails will be sent by LeadHub.

3. Upload Your Logo and Set Your Branding

Go to Settings → Branding. Upload your logo, set your application name (replacing "LeadHub" with your own brand if desired), and choose your primary and accent colors. This affects how the admin panel looks, what appears on the login page, and what is shown in outbound emails.

4. Create Your First Pipeline

Go to Pipelines in the sidebar. Create a pipeline and add stages to it (e.g., "New", "Contacted", "Qualified", "Proposal", "Won", "Lost"). Leads need a pipeline to move through.

5. Connect Your First Lead Source

Go to Lead Sources in the sidebar. Connect your first source — this might be Facebook Lead Ads, a Google Ads form, a web form, or manual entry.

How to Re-Run the Installer

If something goes wrong during installation, or if you need to start over, you can re-run the installer by deleting the installation lock file.

In cPanel File Manager, navigate to your LeadHub folder, then go into storage/. Delete the file named installed.lock. Then visit https://yourdomain.com/install again in your browser.

Warning: Re-running the installer after a complete installation will overwrite your .env file and re-run migrations. Your existing data should survive because migrations use "create if not exists" logic, but it is safest to back up your database first if you are re-installing on an existing database.

Troubleshooting

Problem	Likely Cause	Solution
"Page not found" when visiting /install	Files not in the correct folder, or mod_rewrite not working	Check that files are uploaded to the right location; confirm `public/.htaccess` was uploaded; contact host about mod_rewrite
Blank white page	PHP error or wrong PHP version	Switch to PHP 8.3 in cPanel MultiPHP Manager
"Cannot connect to database" on Step 2	Wrong database credentials	Double-check the database name (include the cPanel prefix), username, and password; make sure the user has all privileges on that database
Requirements page shows red warnings for extensions	PHP extensions not enabled	Go to cPanel → Select PHP Version, enable the missing extensions, refresh installer
"storage is not writable" warning	Permissions not set correctly	Set storage/ to 755 recursively in cPanel File Manager
Installer hangs on "Installing..."	PHP memory limit too low or database issue	Try refreshing; check PHP memory limit in cPanel (needs to be at least 128 MB, preferably 256 MB)
Redirected to /admin but can't log in	Session not saving	Check that storage/framework/sessions/ exists and is writable
"installation failed" error on final step	Database connection lost or file write error	Check your database credentials; check that .env can be written (storage/ and project root must be writable)

Before You Begin​

Step 1 — Upload the LeadHub Files to Your Server​

Download the package​

Upload via cPanel File Manager (easiest method)​

Upload via FTP​

Step 2 — Set File Permissions​

In cPanel File Manager:​

Step 3 — Open the Installer in Your Browser​

Installer Step 1 — Welcome and Requirements Check​

What to do if something fails​

Installer Step 2 — Database Configuration​

How to create a MySQL database in cPanel​

Installer Step 3 — Admin Account​

Installer Step 4 — License​

Installer Step 5 — Finish​

Post-Installation Checklist​

1. Set up the Cron Job (CRITICAL)​

2. Configure Email​

3. Upload Your Logo and Set Your Branding​

4. Create Your First Pipeline​

5. Connect Your First Lead Source​

How to Re-Run the Installer​

Troubleshooting​