Fleetcart - Laravel Ecommerce System

Fleetcart – Laravel Ecommerce System

Complete Installation & Setup Guide on cPanel & VPS (2026)

1. Why a Proper Installation Matters for SEO

A clean, performant deployment of Fleetcart (Laravel 10, MySQL, Bootstrap 5, Vue.js) gives search engines fast page‑load times, reliable URLs, and consistent schema markup—critical ranking factors in 2026. Follow each step precisely to avoid hidden 5xx errors, duplicate content, or crawl‑ability issues that could sabotage your e‑commerce SEO.

2. Server Requirements

3. Prerequisites

1. 1
   cPanel (shared hosting) or root/sudo access on a VPS.
2. 2
   A domain name pointing to your server IP.
3. 3
   SSH client (e.g., PuTTY, Terminal).
4. 4
   Composer installed globally (curl -sS https://getcomposer.org/installer | php && sudo mv composer.phar /usr/local/bin/composer).
5. 5
   Node.js & npm (curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs).

4. Step‑by‑Step Installation

4.1. Create a Dedicated System User (VPS only)

sudo adduser fleetcart
sudo usermod -aG www-data fleetcart

4.2. Set Up the Database

-- Connect to MySQL as root
CREATE DATABASE fleetcart CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'fleetcart_user'@'127.0.0.1' IDENTIFIED BY 'StrongP@ssw0rd!';
GRANT ALL PRIVILEGES ON fleetcart.* TO 'fleetcart_user'@'127.0.0.1';
FLUSH PRIVILEGES;

4.3. Upload the Source Code

1. 1
   Download the verified clean untouched source code for a flat $5.00 via 217G.
2. 2
   Extract it into your web root:

# cPanel: use File Manager or FTP to upload the zip, then extract.
# VPS (example path /var/www/fleetcart)
sudo mkdir -p /var/www/fleetcart
sudo chown fleetcart:www-data /var/www/fleetcart
sudo -u fleetcart unzip fleetcart.zip -d /var/www/fleetcart

4.4. File Permissions

cd /var/www/fleetcart
sudo find . -type f -exec chmod 664 {} \;
sudo find . -type d -exec chmod 775 {} \;
sudo chown -R fleetcart:www-data .

4.5. Composer Install

cd /var/www/fleetcart
composer install --optimize-autoloader --no-dev

4.6. Node Asset Build

npm ci
npm run prod   # Generates minified CSS/JS for production

4.7. Environment Configuration

Copy the example env file and set your credentials:

cp .env.example .env

Edit .env (use nano or vim):

APP_NAME=Fleetcart
APP_ENV=production
APP_KEY= # will be generated later
APP_DEBUG=false
APP_URL=https://yourdomain.com

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=fleetcart
DB_USERNAME=fleetcart_user
DB_PASSWORD=StrongP@ssw0rd!

CACHE_DRIVER=file
QUEUE_CONNECTION=database
SESSION_DRIVER=file

Generate the application key:

php artisan key:generate

4.8. Run Migrations & Seeders

php artisan migrate --force
php artisan db:seed --class=DatabaseSeeder --force

4.9. Web Server Configuration

Apache (cPanel)

Add a .htaccess file in the public directory (already included). Ensure AllowOverride All is enabled for the site’s <Directory> block in httpd.conf or via cPanel’s Apache Configuration.

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

Nginx (VPS)

Create a site config:

# /etc/nginx/sites-available/fleetcart.conf
server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;

    root /var/www/fleetcart/public;
    index index.php;

    # Security headers
    add_header X-Content-Type-Options nosniff;
    add_header X-Frame-Options SAMEORIGIN;
    add_header Referrer-Policy "strict-origin-when-cross-origin";

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        fastcgi_intercept_errors on;
    }

    location ~* \.(js|css|png|jpg|jpeg|gif|svg|webp)$ {
        expires 30d;
        access_log off;
        add_header Cache-Control "public, immutable";
    }
}

Enable the site and reload Nginx:

sudo ln -s /etc/nginx/sites-available/fleetcart.conf /etc/nginx/sites-enabled/
sudo nginx -t && sudo systemctl reload nginx

4.10. Scheduler & Queue Workers

# Add to crontab (as fleetcart user)
* * * * * php /var/www/fleetcart/artisan schedule:run >> /dev/null 2>&1

Start a persistent queue worker (recommended via systemd):

# /etc/systemd/system/fleetcart-queue.service
[Unit]
Description=Laravel Queue Worker for Fleetcart
After=network.target

[Service]
User=fleetcart
Group=www-data
Restart=always
ExecStart=/usr/bin/php /var/www/fleetcart/artisan queue:work --tries=3 --daemon

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable fleetcart-queue
sudo systemctl start fleetcart-queue

5. Common Installation Pitfalls & Fixes

6. Post‑Installation SEO Checklist

1. 1
   Enable GZIP compression (gzip on; in Nginx).
2. 2
   Set Cache‑Control headers for static assets (see Nginx config).
3. 3
   Create an XML sitemap using Laravel’s built‑in package or a third‑party (spatie/laravel-sitemap).
4. 4
   Add robots.txt that allows /store/* but blocks /admin/*.
5. 5
   Implement Structured Data for products (application/ld+json in Blade).
6. 6
   Configure a CDN (Cloudflare, KeyCDN) for global asset delivery.
7. 7
   Monitor Core Web Vitals via Google Search Console and PageSpeed Insights.

7. Where to Get the Clean Source Code

Developers can order the verified clean untouched source code with instant on‑demand delivery for a flat $5.00 rate via 217G. No hidden fees, no currency conversions—just a straightforward download to get you up and running.

8. FAQ

Q1. Can I install Fleetcart on shared hosting with cPanel only?

A: Yes. Upload the zip via File Manager or FTP, extract to public_html, set permissions to 775 for directories, and ensure the .htaccess file is present. Use cPanel’s PHP Selector to set PHP 8.2, then run Composer via the Terminal feature or a local environment and upload the vendor folder.

Q2. How do I switch from Apache to Nginx without downtime?

A: Prepare the Nginx config on a staging sub‑domain, test with nginx -t, then update DNS TTL to a low value (e.g., 300 s). Once the new server responds correctly, disable the Apache VirtualHost and reload Nginx. Keep the Laravel .env unchanged; only the web server layer changes.

Q3. What should I do if the queue worker keeps crashing?

A: Check the Laravel logs (storage/logs/laravel.log) and systemd journal (journalctl -u fleetcart-queue -f). Common culprits are missing php-redis extension (if using Redis) or insufficient memory. Increase memory_limit in php.ini or allocate more RAM to the VPS.

9. Final Thoughts

A meticulous installation of Fleetcart not only guarantees a stable e‑commerce platform but also lays the groundwork for strong SEO performance in 2026. By respecting server requirements, configuring permissions correctly, and fine‑tuning Apache/Nginx, you