Skip to main content

System Requirements

Before installing Open Core Business Suite, ensure your server meets the following requirements.

Server Requirements​

Minimum Requirements​

ComponentRequirement
PHP8.2 or higher
MySQL8.0+ or MariaDB 10.6+
Node.js18+ with npm
Composer2.x
Memory4GB RAM minimum
Storage10GB minimum
ComponentRecommendation
PHP8.3+
MySQL8.0
Memory8GB+ RAM
Storage50GB+ SSD
Redis6.0+ (for queues/cache)
Production Servers

For production servers with 4-8GB RAM, use the optimized build command (npm run build:server:optimized) to reduce memory usage during asset compilation.

Required PHP Extensions​

The following PHP extensions must be installed and enabled:

ExtensionPurpose
BCMathArbitrary precision mathematics
CtypeCharacter type checking
FileinfoFile type detection
JSONJSON encoding/decoding
MbstringMultibyte string handling
OpenSSLSecure encryption
PDODatabase abstraction
PDO_MySQLMySQL database driver
TokenizerPHP token parsing
XMLXML parsing
cURLHTTP client
ZipArchive handling

Verify PHP Extensions​

Run this command to check if required extensions are installed:

php -m | grep -E "bcmath|ctype|fileinfo|json|mbstring|openssl|pdo|tokenizer|xml|curl|zip"

Or check using PHP:

php -r "
\$required = ['bcmath','ctype','fileinfo','json','mbstring','openssl','pdo_mysql','tokenizer','xml','curl','zip'];
foreach (\$required as \$ext) {
    echo \$ext . ': ' . (extension_loaded(\$ext) ? 'OK' : 'MISSING') . PHP_EOL;
}
"

PHP Configuration​

Recommended php.ini settings for optimal performance:

memory_limit = 256M
upload_max_filesize = 50M
post_max_size = 50M
max_execution_time = 300
max_input_vars = 3000

Optional Components​

Redis​

Redis is optional but recommended for production environments:

  • Queue processing - Better performance than database queues
  • Cache storage - Faster than file-based caching
  • Session storage - Improved session handling
# Install Redis (Ubuntu/Debian)
sudo apt install redis-server

# Start Redis service
sudo systemctl start redis
sudo systemctl enable redis

Web Server​

Either Apache or Nginx is required:

ServerVersion
Apache2.4+ with mod_rewrite
Nginx1.18+

Development Environment​

For local development, you can use:

  • Laravel Sail - Docker-based development environment
  • Laragon - Windows development environment
  • MAMP/XAMPP - Cross-platform stacks
  • Valet - macOS development environment

Browser Support​

The web application supports modern browsers:

  • Chrome 90+
  • Firefox 90+
  • Safari 14+
  • Edge 90+

Mobile Apps Requirements​

If you plan to build the mobile applications:

Employee App & Field Sales App (Flutter)​

ToolVersion
Flutter SDK3.8.1+ (3.9.2+ recommended)
Android SDKAPI 26+
iOS SDKiOS 13+ (for iOS builds)
Java17+

Attendance Device (Kotlin/Android)​

ToolVersion
Android StudioHedgehog+
Android SDKAPI 36
Java17
NDK27.0.12077973

Next Steps​

Once your server meets these requirements, proceed to the Installation Guide.

Last updated on