Skip to main content

Installation

The engine's installation process is somewhat more involved than other products. For installing the engine, you need composer, PHP, and a bit of patience. However, there's also a simpler method if you prefer not to deal with composer installation.

Requirement List​

  • PHP version 7.4 or higher, with the following extensions:
    • php-zip
    • php-mbstring
    • php-json
    • php-pdo
    • php-ctype
    • php-bcmath
    • php-zlib (Optional)
    • php-curl
    • php-gmp
    • php-intl
    • php-gd
    • php-mysql
  • MySQL 5.7.29 or higher / MariaDB 10.2.7 or higher.
  • Apache or Nginx web server.
  • Recommended having an SSL certificate.

On some OS, manual installation of required extensions might be necessary.

Installation with Composer​

  1. Prepare an empty directory on your server for CMS.
  2. Download the latest release from GitHub into the directory.
  3. Execute composer install in the Flute directory to install dependencies.
  4. Change the url parameter inside config/app.php to your site URL.
  5. Refer to the configuration section for web server setup.
note

For hosting without full SSH access, refer to composer installation for shared hosting.

Simpler Installation without Composer​

For a more straightforward setup, especially useful on shared hosting without SSH access:

  1. Download both Flute and the vendor folder from the releases.
  2. Upload them to your hosting environment via FTP or your hosting provider's file manager.
  3. Adjust your web server settings to point to the Flute folder.
  4. Ensure you update the config/app.php with your site URL.

This approach eliminates the need for manual composer dependency management.

Composer Installation for Shared Hosting​

If your hosting lacks full SSH access:

  1. Upload the unpacked Flute directory to your site directory.
  2. Connect to your site's SSH (SSH connection details are typically provided by your hosting provider).
  3. Navigate to the Flute directory (cd path/to/flute).
  4. Transfer the composer.phar file to the Flute directory.
  5. Run php composer.phar install (or php74 composer.phar install if using PHP 7.4) to install dependencies.
warning

Config URL update in config/app.php is mandatory for proper site functionality.

After completing these steps, your Flute CMS should be ready to use. 🎇