Requirements

Overview

Before installing Flint Engine, make sure your server meets the following requirements. Failing to meet these requirements may cause installation errors or runtime issues.

Server Requirements

Required PHP Extensions

The following PHP extensions must be enabled on your server:

• pdo_mysql — Database connection
• mbstring — Multi-byte string handling
• xml — XML parsing
• cURL — HTTP requests for email and integrations
• gd or imagick — Image processing for media uploads
• zip — Archive handling
• json — JSON data processing
• openssl — Encryption and secure connections
• fileinfo — File type detection

Optional PHP Extensions

• redis — Recommended for production caching (Redis server required)
• bcmath — Precise decimal calculations for payment processing
• exif — EXIF data handling for image metadata

Directory Permissions

The following directories must be writable by the web server:

• storage/ — Logs, cache, and sessions
• storage/uploads/ — Media file uploads
• bootstrap/cache/ — Framework cache files

Run these commands after installation:

chmod -R 755 storage/
chmod -R 755 bootstrap/cache/
chown -R www-data:www-data storage/ bootstrap/cache/

Environment Configuration

Flint Engine uses a .env file for configuration. You will need to set:

• APP_KEY — Generated during installation
• DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD — Database credentials
• REDIS_HOST — If using Redis caching
• MAIL_HOST, MAIL_PORT, MAIL_USERNAME, MAIL_PASSWORD — SMTP settings

Recommended Production Setup

• PHP 8.2+ with OPcache enabled
• MySQL 8.0 or MariaDB 10.6+
• Redis 6.0+ for caching and sessions
• Nginx with HTTP/2 and gzip compression
• SSL certificate for HTTPS
• Composer for dependency management