๐Ÿš€ Step-by-Step Installation Guide

Get MarketPro
live in minutes.

Follow this guide to install, configure, and launch your MarketPro multi-vendor store. No prior Laravel experience required โ€” every step is explained clearly.

โฑ๏ธLocal setup:~5 min
๐ŸŒShared hosting:~20 min
๐ŸงVPS (Ubuntu):~30 min
1
Prerequisites
Make sure your environment is ready before starting
โœ“
Check PHP version
PHP 8.1 minimum ยท 8.2+ recommended
โ–ผ

Run this command to check your PHP version. MarketPro requires PHP 8.1 or higher.

php --version
# Should output: PHP 8.2.x (or higher)

Also verify these required extensions are enabled:

php -m | grep -E "pdo|mbstring|openssl|tokenizer|xml|curl|gd|fileinfo|zip"
# All 9 should appear in the output
โœ…
XAMPP / WAMP / Laragon users: PHP 8.1+ is included. Use Laragon for the smoothest Windows development experience โ€” it configures everything automatically.
2
Install Composer
PHP dependency manager โ€” required for Laravel
โ–ผ

Download and install Composer from getcomposer.org or use these commands:

# Linux / macOS
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Verify installation
composer --version
# Should output: Composer version 2.x.x

Windows users: download the Composer-Setup.exe installer from getcomposer.org โ€” it handles everything automatically.

3
Prepare MySQL database
Create a database and user for MarketPro
โ–ผ
# Log into MySQL
mysql -u root -p

# Create database and user
CREATE DATABASE marketpro CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'marketpro_user'@'localhost' IDENTIFIED BY 'StrongPassword123!';
GRANT ALL PRIVILEGES ON marketpro.* TO 'marketpro_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
๐Ÿ’ก
cPanel users: Use the MySQL Databases section in cPanel to create the database and user. Note down the database name, username, and password โ€” you'll need them in the next phase.
2
Installation
Get MarketPro installed and configured
1
Extract and install dependencies
Unzip the project and run Composer
โ–ผ

Extract the marketpro.zip to your desired location, then navigate into the folder:

cd marketpro
composer install
# This downloads ~30MB of Laravel packages โ€” takes 1-3 minutes
โš ๏ธ
Shared hosting note: If composer install times out via SSH, run it locally first and upload the generated vendor/ folder via FTP/SFTP. It's large (~80MB) but this is a one-time operation.
2
Create environment file
Copy .env.example and generate app key
โ–ผ
cp .env.example .env
php artisan key:generate
# Output: Application key set successfully.
3
Configure .env file
Set database, mail, and optional API keys
โ–ผ

Open .env in a text editor and update these values:

## App
APP_NAME="My Marketplace"
APP_URL=http://localhost:8000
APP_ENV=local           # Change to "production" when live
APP_DEBUG=true         # Change to "false" in production

## Database
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=marketpro
DB_USERNAME=marketpro_user
DB_PASSWORD=StrongPassword123!

## Mail (optional โ€” needed for order emails)
MAIL_MAILER=smtp
MAIL_HOST=smtp.gmail.com
MAIL_PORT=587
MAIL_USERNAME=your@email.com
MAIL_PASSWORD=your-app-password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=noreply@yourstore.com
MAIL_FROM_NAME="My Marketplace"

## AI Features (optional)
ANTHROPIC_API_KEY=sk-ant-api03-...   # Leave empty to skip AI
โœ…
Payment & SMS keys are NOT in .env. After installation, configure Stripe, PayPal, Twilio etc. from the Admin Panel UI โ€” credentials are stored securely in the database.
4
Run the one-step installer
โšก This single command sets up everything
โ–ผ
php artisan marketpro:install

This command automatically:

  • โœ“
    Creates all 11 upload directories in public/uploads/
  • โœ“
    Runs all database migrations (creates 40+ tables)
  • โœ“
    Seeds demo data: admin, vendor, and customer accounts
  • โœ“
    Seeds all default settings (currency, language, theme colors)
  • โœ“
    Creates resources/lang/en.json base language file
  • โœ“
    Clears config, route, view, and application caches
๐Ÿ’ก
Re-installing? Use php artisan marketpro:install --fresh to drop all tables and start clean. Use --no-seed to skip demo data (good for production).
5
Start and verify
Launch the dev server and test all panels
โ–ผ
php artisan serve
# Server running at: http://127.0.0.1:8000

Test all three demo accounts:

๐Ÿ‘‘
Admin
admin@marketpro.com
Admin@12345
/admin
๐Ÿช
Vendor
vendor@marketpro.com
Vendor@12345
/vendor
๐Ÿ›’
Customer
customer@marketpro.com
Customer@12345
/login
3
Configuration
Customise your marketplace before launch
1
General Settings
Admin โ†’ Settings โ†’ General
โ–ผ
  • โœ“
    Set your Site Name, Tagline, and Contact Email
  • โœ“
    Set Currency Symbol (e.g. $) and Currency Code (e.g. USD)
  • โœ“
    Set Currency Decimals (2 for most currencies, 0 for JPY/KRW)
  • โœ“
    Enable Multi-Currency Switcher if you want customers to switch currencies
  • โœ“
    Set Free Shipping Threshold (e.g. $50 = orders over $50 ship free)
  • โœ“
    Set Global Return Days (default: 30 โ€” products can override this)
  • โœ“
    Set Default Commission Rate per vendor sale (e.g. 10%)
2
Branding & Theme
Admin โ†’ Branding & Theme
โ–ผ
  • โœ“
    Upload your Logo (PNG or SVG recommended, max 2MB)
  • โœ“
    Upload your Favicon (ICO or PNG, 32ร—32px, max 512KB)
  • โœ“
    Pick a Primary Color from 8 presets or enter a custom hex code
  • โœ“
    Choose a Font Family from 10 Google Font options
  • โœ“
    Set Border Radius to match your brand style (none to full/pill)

Changes apply immediately to all pages without clearing cache โ€” the theme CSS is generated dynamically on each request.

3
Payment Gateways
Admin โ†’ Payments โ†’ Payment Gateways
โ–ผ

Enable and configure whichever gateways you want to accept. At minimum, enable Cash on Delivery so customers can place test orders immediately.

๐Ÿ’ก
Stripe test mode: Use test keys from your Stripe dashboard (pk_test_... and sk_test_...) during development. Switch to live keys (pk_live_...) before launch.
  • โœ“
    Enable COD (no config needed โ€” instant)
  • โœ“
    Enable Stripe and paste your Publishable Key + Secret Key
  • โœ“
    Enable PayPal and paste Client ID + Secret. Toggle Sandbox mode for testing.
  • โœ“
    Enable Bank Transfer and add your account details in the instructions field
4
AI Features (optional)
Admin โ†’ AI Features
โ–ผ

If you have an Anthropic API key, add it to your .env first:

ANTHROPIC_API_KEY=sk-ant-api03-your-key-here

Then go to Admin โ†’ AI Features and toggle the master switch ON. You can enable individual features selectively โ€” only enable what you need to manage API costs. Every feature that's off falls back gracefully to a non-AI alternative.

โœ…
Recommended starter AI features: AI Description Generator (huge time-saver for adding products) + AI Fraud Detection (protects against chargebacks) + AI Chat Widget (improves customer support).
5
Create your first vendor
Either invite or create a vendor account
โ–ผ

Option A โ€” Vendor self-registers: Direct vendors to /vendor/register. Their account will be pending approval. Go to Admin โ†’ Vendors to approve them.

Option B โ€” Create from admin: Go to Admin โ†’ Vendors โ†’ Add Vendor. Fill in shop name, email, and password. The account is created as approved immediately.

Option C โ€” Auto-approve all vendors: Go to Admin โ†’ Settings โ†’ General and enable "Auto-Approve Vendors". New vendor registrations will be instantly approved.

4
Production Deployment
Go live on your server or hosting
1
Shared Hosting (cPanel)
The easiest deployment path
โ–ผ
โ‘  Upload files
Upload all MarketPro files to your hosting (e.g. public_html/). Keep public/ as the web root.
โ‘ก Point domain to public/
In cPanel โ†’ Domains, point your domain's document root to the public/ subfolder. This is essential โ€” never expose the project root.
โ‘ข Create database in cPanel
Use MySQL Databases in cPanel. Create a database, a user, and assign the user full privileges on that database.
โ‘ฃ Run installer via SSH
If SSH is available: php artisan marketpro:install --no-seed. If not: import marketpro_schema.sql manually via phpMyAdmin.
2
VPS / Cloud Server (Ubuntu)
Nginx + PHP-FPM + MySQL
โ–ผ
# Install dependencies
sudo apt update && sudo apt install -y nginx mysql-server php8.2-fpm \
  php8.2-mysql php8.2-mbstring php8.2-xml php8.2-curl php8.2-gd \
  php8.2-zip php8.2-intl unzip git

# Clone or upload project to /var/www/marketpro
cd /var/www/marketpro
composer install --no-dev --optimize-autoloader
cp .env.example .env && php artisan key:generate

# Configure Nginx
# Set root to /var/www/marketpro/public

# Set permissions
sudo chown -R www-data:www-data /var/www/marketpro
sudo chmod -R 755 /var/www/marketpro/public/uploads

# Install and run
php artisan marketpro:install --no-seed
php artisan config:cache && php artisan route:cache && php artisan view:cache
3
Production checklist
Before going live
โ–ผ
  • โœ“
    Set APP_ENV=production and APP_DEBUG=false in .env
  • โœ“
    Set APP_URL to your actual domain (e.g. https://mystore.com)
  • โœ“
    Install SSL certificate (Let's Encrypt via Certbot is free)
  • โœ“
    Switch payment gateways from sandbox/test to live mode
  • โœ“
    Configure real SMTP credentials for transactional email
  • โœ“
    Set up a cron job for php artisan schedule:run (runs every minute)
  • โœ“
    Run php artisan marketpro:create-admin to create your real admin account
  • โœ“
    Delete or change all demo account passwords
  • โœ“
    Test a complete order flow end-to-end (add to cart โ†’ checkout โ†’ payment โ†’ invoice)
  • โœ“
    Configure Google Analytics or your preferred analytics in Admin โ†’ Settings โ†’ SEO
# Add to crontab (crontab -e)
* * * * * cd /var/www/marketpro && php artisan schedule:run >> /dev/null 2>&1

You're live! ๐Ÿš€

Your MarketPro marketplace is ready. Explore the full documentation for advanced configuration, or check out all the features in your admin panel.