Installing / Uninstalling

Question What are the prerequisites for installing Composr?
Answer Before installing Composr, ensure your web host meets the minimum requirements. Familiarize yourself with your web host's control panel (e.g., Plesk, cPanel), which you'll use to manage databases, subdomains, and other settings. Gather your SFTP/FTP credentials (hostname, username, password), usually emailed upon signup. Set up a MySQL database and note its details: hostname (often 'localhost'), username, password, and database name. Ensure the database user has full read/write/administer access to the database.
Question How do I install Composr on Linux?
Answer After ensuring your web host meets the requirements and you have a database ready, you can install Composr on Linux using the following steps:
  • Upload the Composr files to your web directory.
  • Navigate to the install.php file in your web browser.
  • Follow the on-screen instructions, providing the required information, such as database details and administrator credentials.
  • After the installation is complete, delete the install.php file for security reasons.
Question How do I set the correct file permissions for Composr?
Answer If you're using the quick installer, it will handle file permissions automatically. On a suEXEC-style server, default permissions (744 for directories and 644 for files) are usually sufficient. However, _config.php should have 600 permissions for security.

Without suEXEC, specific directories (e.g., caches, uploads) and files (e.g., _config.php) require 777 (full access) or 666 (read/write) permissions. The fixperms.php script can automate this process on Linux and Windows.
Question Can I install Composr on a Windows desktop?
Answer Yes, you can install Composr on a Windows desktop using software packages like WampServer, XAMPP, EasyPHP, or ampps for simplified setup. Alternatively, you can manually install Apache, PHP, and MySQL, following the instructions provided in the respective documentation. Remember to configure file permissions appropriately and ensure the webserver isn't accessible from outside your network.
Question What are the recommended web hosting options for Composr?
Answer Choosing a web host is crucial. Avoid the cheapest options and look for hosts with recent positive reviews and minimal credible complaints. Ensure they meet Composr's requirements, including adequate disk space, no restrictive file size limits, and support for required PHP extensions.

Composr is compatible with various hosting control panels like Plesk and cPanel, and works on Windows, Linux, or Mac OS servers.
Question How do I uninstall Composr?
Answer To uninstall Composr, access the uninstall.php file in your web browser, enter your administrator password, and follow the prompts to remove the database data. Afterward, you can safely delete the Composr installation directory.
Question What are the web server requirements for running Composr?
Answer Composr is compatible with Apache and IIS servers.

For Apache:
  • Enable mod_rewrite for URL Schemes or URL Redirects.
  • Ensure AllowOverride All or at least AllowOverride Options FileInfo Limit is set in the server configuration.
  • Recommended modules for optimal performance include mod_headers, mod_setenvif, mod_env, mod_deflate, and mod_filter.

For IIS:
  • Don't disable default Feature Delegation for settings changed in the bundled web.config file.
  • Install the URL Rewrite module, essential for URL Schemes, URL Redirects, and basic security.
  • Configure IIS for additional mime-types if needed, as it doesn't serve unrecognized file types by default.
Question What are the PHP requirements for running Composr?
Answer Composr requires PHP 7.2 or higher, but versions not officially supported by PHP developers are discouraged. The maximum tested version is PHP 8.3.

Required PHP extensions:
  • GD2 (gd) with PNG and JPEG support
  • MySQL extension (mysqli or pdo_mysql)
  • XML extension (xml)
  • Multibyte String (mbstring)
  • cURL extension (curl)
  • JSON support (usually available by default)
  • Sodium (libsodium)
  • ZIP extension (zip) if ZIP file support is needed

Additional recommendations:
  • posix extension for permission checks
  • zlib extension for faster upgrades, compressed backups, and page compression
  • ctype extension for slightly faster performance
  • IMAP extension (imap) for managing newsletter bounces
  • OpenSSL extension (openssl) for encrypted CPFs, DKIM, and SSL certificate expiry checks
  • Pspell (pspell) or Enchant (enchant) extensions for spell checking

Ensure the following PHP settings are configured:
  • File upload size limit of at least 5MB (or higher as needed)
  • Maximum execution time of at least 30 seconds
  • Memory limit of at least 128MB
  • The installer will warn you if any critical functions have been disabled via disable_functions or other PHP modifications. Avoid web hosts that heavily restrict standard PHP functionality.
Question What forum drivers does Composr support?
Answer Composr supports several forum drivers, including Invision Board, phpBB, myBB, vBulletin, Burning Board, and Simple Machine Forum. If your forum is not listed, professional developers can add support. Composr also provides converters for migrating from these forums to its own forum system, Conversr.