How to Install Fusio on Debian Latest

This tutorial will guide you through the process of installing Fusio, an open-source API management platform, on Debian Latest.

Prerequisites

To install Fusio on Debian Latest, you will need the following:

  • A Debian Linux server with root access.
  • PHP 7.2 or higher installed on your server.
  • Git installed on your server.
  • Composer installed on your server.
  • Apache web server installed on your server.

Step 1: Install Required Packages

Before installing Fusio, you need to install the following packages:

$ sudo apt-get update
$ sudo apt-get install unzip
$ sudo apt-get install libcurl4-openssl-dev
$ sudo apt-get install php-curl
$ sudo apt-get install php-xml
$ sudo apt-get install php-mbstring
$ sudo apt-get install php-xmlrpc
$ sudo apt-get install php-json

Step 2: Clone the Fusio Repository

Next, clone the Fusio repository to your server using the following command:

$ git clone https://github.com/apioo/fusio.git

This command will clone the Fusio repository to a new directory named fusio.

Step 3: Install Required PHP Extensions

Change your current working directory to the fusio directory and install the required PHP extensions using the following command:

$ cd fusio
$ composer install

This command will install all the required PHP extensions for Fusio.

Step 4: Configure Apache

Create a new virtual host for Fusio by creating a new Apache configuration file using the following command:

$ sudo nano /etc/apache2/sites-available/fusio.conf

Add the following content to the file:

<VirtualHost *:80>
    ServerName example.com

    DocumentRoot /path/to/fusio/public

    <Directory "/path/to/fusio/public">
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog ${APACHE_LOG_DIR}/fusio_error.log
    CustomLog ${APACHE_LOG_DIR}/fusio_access.log combined
</VirtualHost>

Save and close the file.

Step 5: Enable the Virtual Host

Enable the Fusio virtual host by running the following command:

$ sudo a2ensite fusio.conf

Restart Apache to apply the changes:

$ sudo systemctl restart apache2

Step 6: Set Up the Database

Create a new MySQL database for Fusio and grant privileges to a new user:

$ mysql -u root -p
mysql> CREATE DATABASE fusio;
mysql> GRANT ALL PRIVILEGES ON fusio.* TO 'fusio'@'localhost' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;
mysql> exit;

Replace password with a strong password.

Step 7: Configure the Env File

Create a new .env file from the .env.dist file:

$ cp .env.dist .env

Open the .env file with an editor:

$ nano .env

Update the following parameters with your database details:

DB_HOST=127.0.0.1
DB_PORT=3306
DB_NAME=fusio
DB_USER=fusio
DB_PASS=password

Replace password with the password you set for the fusio MySQL user.

Step 8: Set Up the Database Schema

Run the following command to set up the database schema:

$ vendor/bin/fusio install

Step 9: Access Fusio

You can now access Fusio using a web browser. Enter http://example.com in the address bar and press Enter. Fusio's home page should load successfully.

Congratulations! You have successfully installed Fusio on Debian Latest.