Bulk Image Converter Pro

Installation and configuration guide.

Server Requirements

PHP 8.0+
MySQL/MariaDB
PHP extensions: GD (or Imagick), ZipArchive, PDO MySQL
Apache (recommended) with mod_rewrite enabled

Quick Install (Shared Hosting)

Upload the project files to public_html (or your web root).
Create a MySQL database and user in your hosting control panel.
Import database.sql into your database.
Set writable permissions for: temp/, logs/.
Configure DB env vars (recommended) or edit the DB credentials in your hosting environment.

Environment Variables

Recommended configuration uses environment variables. Copy .env.example to .env and set values.

APP_ENV=production
DB_HOST=localhost
DB_NAME=your_database_name
DB_USER=your_database_user
DB_PASS=your_database_password
DB_CHARSET=utf8mb4
GUEST_CREDITS_SECRET=change_me_to_a_long_random_string
TRUST_PROXY_HEADERS=0
TRUSTED_PROXY_IPS=

Admin Access

For security, do not ship a default admin password in production. Create an admin user from the database, or use the provided CLI tool.

php tools/create_admin.php --username=admin --password="your-strong-password"

CDN Dependencies

This item references external CDNs for Tailwind CSS and Google Fonts/Icons by default. If your deployment requires offline assets, you can replace these with locally hosted files. See THIRD_PARTY_NOTICES.md for attribution.

Troubleshooting

If uploads fail, increase upload_max_filesize and post_max_size.
If ZIP downloads fail, ensure the ZipArchive extension is enabled.
If conversions fail, ensure GD or Imagick is installed.

Support

Update the support email from the Admin settings page after installation.