fusio

Fusio

Open Source API Management Platform Turn your business logic into scalable API products for humans and AI agents.

📖 Documentation • 📺 Video Walkthrough (15m) • 💬 Discord Community

---

Fusio is a self-hosted, open-source backend platform and API gateway written in PHP that bridges the gap between your internal infrastructure and the outside world. Whether you are exposing legacy databases, orchestrating microservices, or building custom business logic, Fusio handles the heavy lifting. It transforms your services into a professional API product, complete with an automated developer portal, SDK generation, and monetization tools. With native MCP support, Fusio also acts as a bridge to the AI ecosystem, allowing you to turn your backend logic into tools for autonomous agents.

🚀 Features

• Database API Gateway - Instantly expose legacy SQL/NoSQL databases (MySQL, PostgreSQL, etc.) as REST APIs.
• Microservice Gateway - Securely route, orchestrate, and load-balance traffic between your distributed services.
• Custom API Logic - Build powerful backend logic using reusable actions in PHP or Javascript.
• Agent Development - Use your custom API logic as "Tools" to build and power autonomous AI agents.
• AI-Assisted Development - Generate custom backend logic and schemas using natural language prompts.
• MCP Integration - Native support for the Model Context Protocol to expose APIs to AI ecosystems.
• API Developer Portal - A self-service portal for third-party developers with docs, testing tools, and keys.
• SDK Automation - Zero-effort generation of client SDKs for all major programming languages.
• API Monetization - Turn your API into a product with subscription plans, quotas, and automated billing.
• Analytics & Monitoring - Real-time tracking of API usage, performance metrics, and error logging.

📦 Installation

🐳 Docker

The fastest way to try Fusio locally is with Docker and docker-compose.

services:
  fusio:
    image: fusio/fusio
    restart: always
    environment:
      FUSIO_PROJECT_KEY: "42eec18ffdbffc9fda6110dcc705d6ce"
      FUSIO_CONNECTION: "pdo-mysql://fusio:61ad6c605975@mysql-fusio/fusio"
      FUSIO_BACKEND_USER: "test"
      FUSIO_BACKEND_EMAIL: "demo@fusio-project.org"
      FUSIO_BACKEND_PW: "test1234"
    ports:
      - "8080:80"

  mysql-fusio:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_RANDOM_ROOT_PASSWORD: "1"
      MYSQL_USER: "fusio"
      MYSQL_PASSWORD: "61ad6c605975"
      MYSQL_DATABASE: "fusio"
    volumes:
      - ./db:/var/lib/mysql

docker compose up -d

After startup

• Backend: http://localhost:8080/apps/fusio
• Login with the credentials you configured
• For the first steps, take a look at our Getting Started guide

🛠️ Manual Installation

• Download artifact

  You can either download the official release or clone the repository.

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

• Configure .env

  Configure fitting database credentials at the APP_CONNECTION variable, all other parameters are optional.

  APP_CONNECTION=pdo-mysql://root:password@localhost/fusio
  APP_URL=http://localhost:8080
  

  It is also recommended to provide the APP_URL which contains the domain pointing to the public folder i.e. https://api.my_domain.com or https://my_domain.com/fusio, this is required if you host Fusio inside a sub-folder otherwise Fusio tries to detect the domain via the Host header.

  Supported DBs:

  • MySQL: pdo-mysql://user:pass@host/db
  • PostgreSQL: pdo-pgsql://user:pass@host/db
  • SQLite: pdo-sqlite:///fusio.sqlite

• Run migrations

  php bin/fusio migrate
  

• Create administrator user

  php bin/fusio adduser
  

  Choose Administrator as account type.

• Install backend app

  php bin/fusio marketplace:install fusio
  

• Start server (dev only)

  php -S 127.0.0.1:8080 -t public
  

  This should be only used for testing, for production you need a classical Nginx/Apache setup or use Docker, take a look at our installation documentation for more details.

🌐 Web-Installer

Instead of manual installation you can also use the web installer script located at /install.php to complete the installation. After installation, it is recommended to delete this "install" script.

🧭 Getting Started

Use our Getting Started guide to build your first action and configure an operation to expose the action as API endpoint.

Action

At the core of Fusio, you describe your business logic in an Action. An Action is a PHP class that receives an incoming request and returns a response.

<?php

namespace App\Action;

use Fusio\Engine;

class MyAction implements Engine\ActionInterface
{
    public function handle(Engine\RequestInterface $request, Engine\ParametersInterface $configuration, Engine\ContextInterface $context): mixed
    {
        return [
            'hello' => 'world'
        ];
    }
}

Once defined, this action can be bound to an Operation so that it executes for a specific HTTP method and path.

Configuration

Fusio allows you to build actions that are configurable directly from the backend. In the example below, we add a message configuration parameter so a user can customize the response without changing the code.

<?php

namespace App\Action;

use Fusio\Engine;

class MyAction extends Engine\ActionAbstract
{
    public function handle(Engine\RequestInterface $request, Engine\ParametersInterface $configuration, Engine\ContextInterface $context): mixed
    {
        return [
            'hello' => $configuration->get('message'),
        ];
    }

    public