Skip to main content
Before installing VIP2CARS, ensure your system meets the following requirements.

Server Requirements

PHP

VIP2CARS requires PHP 8.2 or higher.
PHP 8.2+ is required as specified in the composer.json file. Ensure your server has this version or newer installed.

Required PHP Extensions

The following PHP extensions are required by Laravel 12 and the application dependencies:
  • BCMath PHP Extension
  • Ctype PHP Extension
  • cURL PHP Extension
  • DOM PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PCRE PHP Extension
  • PDO PHP Extension
  • PDO MySQL Extension (for MySQL database)
  • Tokenizer PHP Extension
  • XML PHP Extension

Composer

Composer is required to install PHP dependencies. Download from getcomposer.org.

Node.js and npm

Node.js and npm are required to compile frontend assets.
The application uses Vite 7 for asset compilation, which requires Node.js 18 or higher.

Database Requirements

VIP2CARS supports multiple database systems:

Primary Database Options

Recommended for production
  • MySQL 8.0 or higher
  • Default port: 3306
  • Charset: utf8mb4
  • Collation: utf8mb4_unicode_ci
MySQL is the recommended database for VIP2CARS in production environments.
Alternative to MySQL
  • MariaDB 10.3 or higher
  • Default port: 3306
  • Charset: utf8mb4
  • Collation: utf8mb4_unicode_ci
MariaDB is fully compatible and can be used as a drop-in replacement for MySQL.
Development only
  • SQLite 3.8.8 or higher
  • No server required
  • Single file database
SQLite is configured as the default for development but is not recommended for production use.

Optional: Redis

Redis can be used for caching, session storage, and queue management:
  • Redis 5.0 or higher
  • Default port: 6379
  • PHP Redis extension recommended (phpredis)

Key Dependencies

Backend (PHP)

Extracted from composer.json:
{
  "php": "^8.2",
  "laravel/framework": "^12.0",
  "laravel/fortify": "^1.30",
  "laravel/tinker": "^2.10.1",
  "livewire/livewire": "^4.0",
  "livewire/flux": "^2.9.0",
  "livewire/blaze": "^1.0"
}

Frontend (JavaScript)

Extracted from package.json:
{
  "vite": "^7.0.4",
  "tailwindcss": "^4.0.7",
  "@tailwindcss/vite": "^4.1.11",
  "laravel-vite-plugin": "^2.0",
  "axios": "^1.7.4",
  "autoprefixer": "^10.4.20"
}

System Resources

Minimum Requirements

  • CPU: 1 core
  • RAM: 512 MB
  • Disk Space: 500 MB (for application files and database)
  • CPU: 2+ cores
  • RAM: 2 GB+
  • Disk Space: 5 GB+ (depending on data storage needs)
  • SSL Certificate: Required for HTTPS (recommended)

Development Tools (Optional)

Laravel Sail provides a Docker-based development environment:
composer require laravel/sail --dev
Sail is included in the require-dev section (version ^1.41).
Code style fixer based on PHP-CS-Fixer:
composer require laravel/pint --dev
Pint is included (version ^1.24) for maintaining code quality.
Testing framework for running application tests:
composer require pestphp/pest --dev
Pest (version ^3.8) is included for testing.

Verification

After installation, verify your environment meets all requirements:
1

Check PHP version

php -v
Ensure output shows PHP 8.2 or higher.
2

Check PHP extensions

php -m
Verify all required extensions are listed.
3

Check Composer

composer --version
4

Check Node.js

node -v
npm -v
Ensure Node.js 18+ is installed.
5

Check database connection

Test your MySQL/MariaDB connection:
mysql -u root -p

Next Steps

Once your system meets all requirements, proceed to Configuration to set up your environment.

Build docs developers (and LLMs) love