How to install Fusio on macOS

Fusio is an open source API management platform that allows you to build REST APIs for your web applications. In this tutorial, we will walk you through the steps to install Fusio on macOS.

Prerequisites

Before we get started, make sure you have the following prerequisites:

  • macOS Sierra or later versions
  • Homebrew package manager installed
  • PHP 7.4 or later versions installed

Step 1: Install MariaDB

Fusio requires a database to store its data. In this tutorial, we will use MariaDB as our database server. Here's how to install it using Homebrew:

  1. Open the terminal and run the following command to update Homebrew: 

    brew update

  2. Install MariaDB using Homebrew:

    brew install mariadb

  3. Start the MariaDB server:

    mysql.server start

That's it! MariaDB is now installed and running on your macOS.

Step 2: Install Fusio

Now that we have installed MariaDB, it's time to install Fusio:

  1. Open the terminal and navigate to the directory where you want to install Fusio.

  2. Run the following command to download and extract the Fusio package:

    wget https://github.com/apioo/fusio/archive/main.zip -O fusio.zip && unzip fusio.zip && rm fusio.zip

  3. Change directory into the extracted Fusio folder:

    cd fusio-main

  4. Run the following command to install the dependencies:

    php composer.phar install

  5. Run the following command to install Fusio:

    php bin/fusio install

  6. The installation process will prompt you to enter the database credentials for MariaDB. Enter the following:

    • Database name: fusio
    • Database username: root
    • Database password: <leave it blank, hit Enter>

  7. Follow the instructions on the screen to complete the installation process. Once you have successfully installed Fusio, you will see a message saying "Fusio was successfully installed!".

Step 3: Start Fusio

Now that Fusio is installed, it's time to start it up:

  1. Open the terminal and navigate to the Fusio directory:

    cd ~/path/to/fusio-main/

  2. Run the following command to start the PHP server:

    php bin/fusio serve

  3. Open a web browser and go to http://localhost:8080. You should now see the Fusio dashboard.

That's it! You have successfully installed and started Fusio on your macOS machine using Homebrew. You can now start building your own REST APIs using the platform.