System Requirements

Server Requirements

Before installing GigsRabbit, ensure your server meets all requirements. The installer will check these automatically.

PHP Version

• Minimum: PHP 8.2.0
• Recommended: PHP 8.2 latest stable or PHP 8.3

Required PHP Extensions

The following PHP extensions must be installed and enabled:

Database & Core:

• mysqli - Database connectivity
• pdo - Database abstraction layer
• openssl - Security and encryption

Processing & Utilities:

• gd - Image processing and manipulation
• curl - HTTP requests and API calls
• zip - Archive file handling

PHP Core Extensions:

• bcmath - Precise mathematical calculations
• ctype - Character type validation
• fileinfo - File type and MIME detection
• mbstring - Multi-byte string handling
• tokenizer - PHP code tokenization
• xml - XML document processing
• json - JSON encoding and decoding

To check if an extension is installed, run:

php -m | grep extension_name

For example:

php -m | grep mysqli
php -m | grep gd

PHP Configuration

Required php.ini settings:

allow_url_fopen = On
file_uploads = On
upload_max_filesize = 100M
post_max_size = 100M
max_execution_time = 300
memory_limit = 256M

Database Requirements

Supported Database:

• MySQL 5.7 or higher

Database Privileges Required:

• CREATE
• DROP
• ALTER
• INDEX
• SELECT
• INSERT
• UPDATE
• DELETE
• REFERENCES

Web Server Requirements

Apache Requirements:

• Version 2.4 or higher
• mod_rewrite enabled
• .htaccess support enabled
• AllowOverride All

Nginx Requirements:

• Version 1.18 or higher
• PHP-FPM configured
• Proper rewrite rules

Directory Permissions

The following directories must be writable (775 or 777):

• /storage (and all subdirectories)
• /bootstrap/cache
• /public/media
• /resources
• /lang
• /config
• /.env file

Additional Software

Required:

• Composer 2.0 or higher
• Node.js 16+ and NPM 7+ (for asset compilation)

Optional but Recommended:

• Redis (for caching and queues)
• Supervisor (for queue workers)
• Git (for version control)

Server Resources

Minimum Requirements:

• CPU: 2 cores
• RAM: 2GB
• Storage: 10GB SSD
• Bandwidth: Unlimited preferred

Recommended for Production:

• CPU: 4+ cores
• RAM: 4GB or more
• Storage: 50GB+ SSD
• Dedicated IP address
• SSL certificate

Hosting Recommendations

Recommended Providers:

1. VPS/Cloud Hosting:

   • DigitalOcean
   • Linode
   • Vultr
   • AWS EC2
   • Google Cloud

2. Managed Hosting:

   • Cloudways
   • RunCloud
   • Laravel Forge

3. Shared Hosting (minimum requirements):

   • cPanel/WHM based
   • SSH access
   • Cron job support
   • Custom php.ini support

How to Check Requirements

Check PHP Version:

php -v

Check PHP Extensions:

php -m

Check MySQL Version:

mysql --version

Check Available Disk Space:

df -h

Check RAM:

free -m

Pre-Installation Checklist

• [ ] PHP 8.2+ installed
• [ ] All required PHP extensions enabled
• [ ] MySQL/MariaDB installed and running
• [ ] Database created with user privileges
• [ ] Composer installed
• [ ] Node.js and NPM installed
• [ ] Domain pointed to server
• [ ] SSL certificate installed (recommended)
• [ ] Email service configured (SMTP)