====================================================
  SureCommerce — REQUIREMENTS
====================================================

SYSTEM REQUIREMENTS CHECKLIST
==============================

SERVER REQUIREMENTS:
====================

Operating System:
□ Linux (Ubuntu, CentOS, Debian) — Recommended
□ Windows Server
□ macOS (for local development)

Web Server:
□ Apache 2.4+ with mod_rewrite enabled
□ Nginx 1.10+ (Recommended for production)

PHP Version:
□ PHP 8.4 or higher (required)

Database:
□ MySQL 5.7+ or MySQL 8.0+ (Recommended)
□ MariaDB 10.3+

REQUIRED PHP EXTENSIONS:
========================
These MUST be installed and enabled:

□ php-curl      (For API requests)
□ php-gd        (For image processing)
□ php-imagick   (For advanced image manipulation)
□ php-json      (For JSON handling)
□ php-zip       (For file compression)
□ php-mbstring  (For multi-byte strings)
□ php-xml       (For XML processing)
□ php-pdo       (For database)
□ php-pdo_mysql (For MySQL connection)
□ php-bcmath    (For calculations)
□ php-tokenizer (For Laravel)

OPTIONAL PHP EXTENSIONS:
========================
Recommended but not required:

□ php-redis     (For Redis cache — performance boost)
□ php-opcache   (For PHP optimization)

HARDWARE REQUIREMENTS:
======================

Minimum (Small sites, < 1000 users):
□ CPU: 1 Core
□ RAM: 512 MB
□ Disk: 500 MB free space
□ Bandwidth: 1 GB/month

Recommended (Medium sites, 1000–10,000 users):
□ CPU: 2 Cores
□ RAM: 2 GB
□ Disk: 5 GB free space
□ Bandwidth: 10 GB/month

Optimal (Large sites, 10,000+ users):
□ CPU: 4+ Cores
□ RAM: 4+ GB
□ Disk: 20+ GB SSD
□ Bandwidth: 50+ GB/month

ADDITIONAL SOFTWARE:
====================

Required for Installation:
□ Composer (latest version)
□ Git (optional but recommended)

Required for Production:
□ Supervisor or systemd (for queue workers)

Optional — Performance:
□ Redis (for caching and queue)

Optional — Theme Customization Only:
□ Node.js 18+ and NPM (pre-built assets are included
  in the package; Node.js is only needed if you want
  to recompile after customizing SCSS/JS)

For Local Development:
□ Docker Desktop (for Docker installation method)
□ XAMPP / MAMP / WAMP (alternative local setup)

PHP CONFIGURATION:
==================

Minimum php.ini settings:

□ upload_max_filesize = 64M
□ post_max_size = 64M
□ max_execution_time = 300
□ max_input_time = 300
□ memory_limit = 256M
□ max_input_vars = 3000

For Large Operations:
□ memory_limit = 512M or higher
□ max_execution_time = 600 or higher

FILE PERMISSIONS:
=================

These directories need write permissions:

□ storage/ (755 or 775)
□ storage/app/ (755 or 775)
□ storage/framework/ (755 or 775)
□ storage/logs/ (755 or 775)
□ bootstrap/cache/ (755 or 775)
□ public/uploads/ (755 or 775)
□ public/vendor/ (755 or 775)
□ lang/vendor/ (755 or 775)

USER PERMISSIONS:
=================

Web server user (www-data, nginx, apache) needs:
□ Read access to all application files
□ Write access to storage/ and bootstrap/cache/
□ Write access to public/uploads/
□ Execute permission on artisan file

CHECK YOUR SERVER:
==================

Method 1: Create phpinfo.php file
----------------------------------
<?php phpinfo(); ?>

Upload to server and access via browser to see
all PHP settings and loaded extensions.

Method 2: Command Line
----------------------
php -v                  # Check PHP version (must be 8.4+)
php -m                  # List loaded modules
php --ini               # Show php.ini location
composer --version      # Check Composer

Method 3: Laravel Check
-----------------------
After installation, run:
php artisan about       # Show environment info

HOSTING COMPATIBILITY:
======================

✓ Compatible with:
  - cPanel hosting
  - Plesk hosting
  - DirectAdmin hosting
  - VPS (DigitalOcean, Linode, Vultr, AWS, etc.)
  - Dedicated servers
  - Cloud hosting (AWS, Google Cloud, Azure)
  - Cloudways
  - Laravel Forge
  - Laravel Vapor

✗ NOT compatible with:
  - Free hosting (usually lacks required extensions)
  - Shared hosting with PHP < 8.4
  - Hosting without SSH access (harder to manage)
  - Windows hosting without proper PHP setup

NETWORK REQUIREMENTS:
=====================

Firewall Rules:
□ Port 80 (HTTP) open
□ Port 443 (HTTPS) open
□ Port 3306 (MySQL) — internal only

Outgoing Connections:
□ SMTP ports (25, 587, 465) for email
□ Port 443 for Composer and package updates

SSL/TLS:
□ SSL certificate (required for production)
□ Let's Encrypt (free option)

BROWSER COMPATIBILITY:
======================

Admin Panel:
✓ Chrome 90+ (Recommended)
✓ Firefox 88+
✓ Safari 14+
✓ Edge 90+
✗ Internet Explorer (Not supported)

Frontend (Customer Storefront):
✓ All modern browsers
✓ Mobile browsers (iOS Safari, Chrome Mobile)

DEVELOPMENT ENVIRONMENT:
========================

For Local Development:
□ XAMPP (Windows/Mac/Linux)
□ MAMP (Mac)
□ WAMP (Windows)
□ Laravel Valet (Mac)
□ Laravel Homestead (Vagrant)
□ Docker (All platforms) — Recommended
□ Laragon (Windows)

---

QUICK CHECK SCRIPT:
===================

Run this PHP script to check if your server meets
the requirements:

<?php
echo "PHP Version: " . PHP_VERSION . "\n";
$ok = version_compare(PHP_VERSION, '8.4.0', '>=');
echo "PHP 8.4+: " . ($ok ? "✓" : "✗ (REQUIRED)") . "\n\n";
$required = ['curl','gd','imagick','json','zip',
             'mbstring','xml','pdo','pdo_mysql',
             'bcmath','tokenizer'];
foreach($required as $ext) {
    echo $ext . ": " .
         (extension_loaded($ext) ? "✓" : "✗ MISSING") . "\n";
}
?>

---

Need help determining compatibility?
Contact support with your server details before
purchasing.

© 2026 DreamTeam