Skip to main content

Installation

Requirements​

Fusio is written in PHP and requires at least version 8.2 and a database.

  • PHP >= 8.2
  • Database (supports: MySQL, PostgreSQL)

Download​

There are two ways of downloading Fusio:

  • Download the latest release from Github
  • Use composer and run the command composer create-project fusio/fusio

Place the script in the www/ directory of your web server. After successfully downloading Fusio, please continue with the setup process. The setup process will help configure Fusio to work properly on your server.

Setup​

Manual Setup​

  • Adjust the configuration file
    Open the file .env in the Fusio directory and change the key APP_URL to the domain pointing to the public folder. Also insert the database credentials to the APP_CONNECTION keys.

  • Execute the installation command
    The installation script inserts the Fusio database schema into the provided database. It can be executed with the following command php bin/fusio migrate.

  • Create administrator user
    After the installation is complete you have to create a new administrator account. Therefor you can use the following command php bin/fusio adduser. Choose as account type "Administrator".

Installation Script​

To use the install script instead of the manual setup above, point your browser to public/install.php. The script will help setup Fusio and configure it to work on your server.

Once you are done, for security reasons, remove the public/install.php script.

Done​

If the installation is complete you are able to login at the backend at /apps/fusio. In case the fusio folder does not exist you can also manually install the backend app through php bin/fusio marketplace:install fusio.

Please take a look also at our docs regarding a specific platform:

Cloud​

If you don`t want to manually install Fusio you can take a look at our cloud platform which you can use to directly run a Fusio instance in the cloud.

Update​

Backend​

To update the backend we recommend to download the latest release from GitHub and replace the vendor/ folder and the composer.json and composer.lock file. After this you only need to run the following command:

php bin/fusio migrate

Through this command Fusio executes all new migrations to migrate the database structure to the latest version.

Apps​

All apps can be updated at the Marketplace panel of the backend app. There you can simply use the update button to receive the latest version of the app. In case the Marketplace is disabled you can also download the app directly from our website at: https://www.fusio-project.org/marketplace or use our CLI command to update an app to the latest version:

php bin/fusio marketplace:update [name]