Skip to main content

Common Requirements

Before installing Botivus, make sure your system meets the following requirements.

These requirements apply to both local development and server environments (cPanel/VPS).

🧾 General Requirements​

  • PHP Version: PHP 8.2 or higher (Supports up to PHP 8.4)
  • Web Server: Apache, Nginx, or cPanel-based servers
  • Database: MySQL 5.7+ or MariaDB 10.3+
  • RAM: Minimum 1 GB (2 GB or more recommended)
  • Disk Space: At least 2 GB free (4 GB recommended)

✅ Required PHP Extensions​

Ensure these PHP extensions are enabled:

  • BCMath
  • Ctype
  • Fileinfo
  • JSON
  • Mbstring
  • OpenSSL
  • PDO
  • Tokenizer
  • XML
  • cURL
  • Zip
  • gettext
  • exif
  • mysqli
  • GD
  • Intl (for localization support)

🔐 Permissions​

Make sure the following folders are writable:

/storage
/bootstrap/cache

For Linux or macOS, you can run:

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

For Windows, make sure these directories allow write access via file explorer or CMD.

📁 Environment Configuration​

Make sure to copy .env.example to .env:

cp .env.example .env

Then generate the application key:

php artisan key:generate

🕓 Cron Job (For Scheduled Tasks)​

To run automated tasks, setup the following cron job:

* * * * * /usr/bin/php /path-to-your-project/artisan schedule:run >> /dev/null 2>&1

Update /usr/bin/php and /path-to-your-project/ according to your environment.

🧪 Testing Requirements (Optional)​

If you want to run tests:

  • PHPUnit (included via composer)
  • Node.js (for frontend assets)
  • npm or yarn

🌐 Browser Support​

Botivus supports all major modern browsers:

  • Chrome (latest 3 versions)
  • Firefox
  • Safari
  • Edge

If you face any issues with missing extensions or setup errors, please refer to the installation section or contact support.