Installation

Installation

This guide explains how to install LeadFlow AI from the downloaded marketplace package. Use a fresh domain or subdomain, an empty database, correct PHP extensions, and the browser installer. Do not install over another Laravel application or an existing production database.

Downloaded Package Structure

• Documentation/ offline buyer documentation.
• install.zip application files to upload to the server.
• changelog.txt release notes.
• license.txt license terms from the marketplace package.
• addons/ optional modules when bundled by the seller.

Extract the outer package on your computer first, then upload the contents of install.zip to the server. The web server should point to the application's public directory whenever hosting allows it.

Domain, Server, and PHP Requirements

Create a domain such as app.example.com or a root domain such as example.com. Point DNS to the server before starting installation. Recommended requirements are PHP 8.3 or higher, MySQL or MariaDB, 256 MB memory minimum, HTTPS, and a web server such as Apache, Nginx, LiteSpeed, or a compatible hosting panel.

Required PHP extensions normally include ctype, curl, dom, fileinfo, filter, hash, json, mbstring, openssl, pdo, pdo_mysql, tokenizer, xml, and zip. Recommended extensions include gd or imagick for image/media features, intl for localization, bcmath for payment calculations, and redis when queue/cache infrastructure is available.

Writable Paths

The installer must be able to write .env, storage, and bootstrap/cache. If the installer cannot write these paths, fix permissions from SSH or the hosting file manager. After installation, keep permissions as restrictive as your server supports.

Apache Setup

Enable mod_rewrite and allow the included .htaccess rules. The recommended document root is /path/to/leadflow-ai/public. If shared hosting cannot point to public, follow the package hosting instructions carefully and make sure .env, storage, vendor, and framework files cannot be downloaded publicly.

Nginx Setup

server {
    server_name app.example.com;
    root /path/to/leadflow-ai/public;
    index index.php;
    location / { try_files $uri $uri/ /index.php?$query_string; }
    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php8.3-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    }
}

SSL Setup

Enable SSL before inviting users. HTTPS protects login sessions, admin access, payment flows, form submissions, public forms, public funnels, public surveys, QR redirects, webhooks, custom domains, files, and tracking scripts. Use Let's Encrypt or your hosting SSL provider, then confirm the browser opens the app with https://.

Fresh Database Setup

Create an empty database and a database user with permissions to create and modify tables. Keep the database name, host, port, username, and password ready. Do not reuse a database from another application. The installer runs migrations and seeders and expects a clean schema.

Browser Installer

Open https://your-domain.com/installer. The installer checks server requirements, writable paths, purchase verification configuration, database connection, website settings, and administrator account details. Enter the purchase code on the real domain where the product will run. Create the first admin account with a strong password and an email address you control.

What Happens During Installation

The installer writes environment values, verifies the purchase, tests database credentials, runs migrations, seeds default settings, creates the admin user, prepares cache, and marks the application as installed. If a step fails, fix the reported issue and run the installer again only after confirming the database is still suitable.

Post-installation Checklist

• Log in as admin and update website settings, timezone, mail, cache, queue, storage, captcha, AI, and payment settings.
• Create SaaS plans and confirm form, response, funnel, survey, QR, template, AI, automation, report, file, custom domain, support, team, and billing limits.
• Test registration, login, password reset, form publishing, public form submission, funnel URL, survey URL, QR redirect, email automation, webhook, report access, file upload, custom domain, and payment checkout.
• Configure cron to run Laravel Scheduler every minute and start queue workers if required by your hosting.
• Disable debug mode in production and keep backups before importing leads or installing addons.

Common Installation Problems

If the installer is blank, check PHP version, storage permissions, logs, and web server document root. If database setup fails, confirm host, port, credentials, and empty schema. If purchase verification fails, use the real purchase code and production domain. If assets are broken, clear cache and confirm the public path is configured correctly.