fusio/fusio

Fusio project

, _(*1)

Fusio

Self-Hosted API Management for Builders., _(*2)

🚀 Use Cases

• Database API Gateway, _(*3)

  Unlock legacy databases and expose them via modern REST APIs., _(*4)

• Custom Backend Logic for APIs, _(*5)

  Build and manage custom business logic tailored to your domain., _(*6)

• Gateway for Microservices, _(*7)

  Route, orchestrate, and secure traffic between internal services., _(*8)

• API Developer Portal, _(*9)

  Provide docs, testing, and SDKs for internal or external developers., _(*10)

• API Monetization, _(*11)

  Enable freemium or tiered access with quotas, limits, and billing hooks., _(*12)

• MCP Integration, _(*13)

  Leverage the Model Context Protocol to enable AI-driven access and control of API endpoints., _(*14)

• API Usage Analytics, _(*15)

  Monitor traffic, detect issues early, and understand API consumption., _(*16)

• Headless CMS Backend, _(*17)

  Manage and expose structured content to any frontend via APIs., _(*18)

• SDK Automation, _(*19)

  Automatically generate ready-to-use client SDKs (PHP, TypeScript, Python, etc.)., _(*20)

📦 Quick Start

🛠️ Installation

• Download artifact, _(*21)

  You can either download the official release or clone the repository., _(*22)

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

• Set up your .env, _(*23)

  Configure fitting database credentials at the APP_CONNECTION variable, all other parameters are optional., _(*24)

  • MySQL: pdo-mysql://root:test1234@localhost/fusio
  • PostgreSQL: pdo-pgsql://postgres:postgres@localhost/fusio
  • SQLite: pdo-sqlite:///fusio.sqlite

• Run migrations, _(*25)

  php bin/fusio migrate
  

• Create administrator user, _(*26)

  After the installation is complete, you have to create a new administrator account. Choose as account type "Administrator"., _(*27)

  php bin/fusio adduser
  

• Install backend app, _(*28)

  php bin/fusio marketplace:install fusio
  

• Start via PHP built-in server, _(*29)

  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., _(*30)

  php -S 127.0.0.1:8080 -t public
  

🌐 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., _(*31)

🐳 Docker

To run Fusio with Docker you only need the official Fusio docker image and a database. The following example shows a minimal docker-compose.yaml which you can use to run Fusio., _(*32)

version: '3'
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"
    links:
      - mysql-fusio
    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

🧩 Apps

Fusio includes a flexible app system that lets you install various web-based apps to support different API-related use cases. These apps are typically simple JavaScript frontends that interact with Fusio's internal API., _(*33)

You can browse all available apps in the Fusio Marketplace, and install them using either the CLI:, _(*34)

php bin/fusio marketplace:install fusio

or directly through the backend interface., _(*35)

🖥️ Backend

, _(*36)

The backend app is the main app to configure and manage your API located at /apps/fusio/., _(*37)

💡 VSCode

Fusio provides a VSCode extension which can be used to simplify action development., _(*38)

🔗 Integration

🧰 SDK

To build and integrate applications with Fusio, you can use one of our officially supported SDKs, which simplify interaction with a Fusio instance. Alternatively, you can directly communicate with the REST API for full control and flexibility., _(*39)

🖥️ Frontend

📡 REST API

🌍 Ecosystem

Besides our core product, we offer additional services to augment the functionality of Fusio., _(*40)

• SDKgen
  SDKgen is a powerful code generator to automatically build client SDKs for your REST API.
• APIgen
  Generate fully working and customizable APIs based on your data model.
• APImon
  APImon provides an intuitive service to monitor and analyze API endpoints.
• TypeSchema
  A JSON format to describe data models in a language neutral format.
• TypeAPI
  An OpenAPI alternative to describe REST APIs for type-safe code generation.
• TypeHub
  A collaborative platform to design and build API models and client SDKs.
• PSX
  An innovative PHP framework dedicated to build fully typed REST APIs.

🏷️ Domains

By default, the entire Fusio project can be hosted on a single domain. In this setup:, _(*41)

• Your API is served from the root path (e.g., https://acme.com/).
• Web apps like the developer portal and admin backend are accessible under the /apps directory (e.g., https://acme.com/apps/developer).

This setup is quick to get started with and requires no additional configuration. For production environments, we recommend a subdomain-based structure:, _(*42)

• api.acme.com
  Hosts only the Fusio API. In this setup, you can safely remove the apps/ folder from the public/ directory.
• developer.acme.com
  Hosts the Developer App, a portal where third-party developers can register, view documentation, and access their credentials.
• __fusio.acme.com__ (optional)
  Hosts the **Backend App**, used to manage your Fusio instance. You can also host this on a separate internal domain.

Note: This is just a suggested setup. You're free to choose any domain or subdomain structure that best fits your infrastructure., _(*43)

📚 Documentation

Please check out our official documentation website where we bundle all documentation resources:, _(*44)

https://docs.fusio-project.org/, _(*45)

🤝 Support

💬 Get Help

If you have questions or run into issues while using Fusio:, _(*46)

• Open a discussion for general questions, feedback, or feature ideas.
• Report bugs or technical problems via the issue tracker.
• Join our Discord community to chat directly with the developers and other users.

If you're a company or freelancer looking for more tailored help, please check out our consulting services below., _(*47)

📣 Promotion & Media

Are you a blogger, writer, or run a developer-focused publication? We'd love for you to cover Fusio!, _(*48)

Visit the Media Page to download official icons for use in your articles or videos., _(*49)

🧑‍🏫 Consulting & Workshops

For companies or freelancers who want in-depth guidance on using and integrating Fusio:, _(*50)

• We offer consulting services to help you evaluate whether Fusio fits your architecture.
• Our workshops walk you through key functionality, answer your specific questions, and help identify the best integration approach.

Feel free to contact us for more details., _(*51)

💖 Support Fusio

If Fusio helps you build APIs faster or adds value to your projects, please consider supporting our work:, _(*52)

• ⭐ Star the project on GitHub
• ☕ Sponsor via GitHub
• 💬 Spread the word on social media or write about Fusio

Every bit of support helps us continue improving the platform!, _(*53)

🤝 Project Partners

We’re grateful to our partners who support the Fusio project and share our vision of advancing open API development., _(*54)

If your company is interested in becoming a partner and being listed here, consider becoming a sponsor., _(*55)

, _(*56)