F

Fusio

2.1k stars·Developer Tools·SHA-256 checksum verified

Fusio is an open source API management platform that transforms your business logic into scalable API products for both humans and AI agents.

Smart Download

Visit Project Homepage

No installer available yet — head to the source repository

Self-hosted API platform with built-in monetization and AI agent connectivity, no heavy coding needed.

Core Features

  • Database API Gateway: instantly expose MySQL/PostgreSQL as REST APIs
  • Microservice Gateway: secure routing, orchestration, and load balancing
  • Custom logic: build reusable actions in PHP or JavaScript
  • AI-assisted development: generate backend logic from natural language (Ollama/ChatGPT/Gemini)
  • MCP native support: connect APIs to AI ecosystems via Model Context Protocol

What It Can't Do

  • •For production, use Nginx/Apache, not the built-in PHP server. Always change the default `FUSIO_PROJECT_KEY` and database passwords before deploying. If hosted in a subdirectory, set `APP_URL` manually to avoid domain detection issues.

Use Cases

  • Wrap legacy databases into REST APIs for modern apps
  • Build monetizable API products (weather, payment, data services)
  • Create backend tools for AI agents (ChatGPT plugins, Claude tools)

Detailed Introduction

Fusio is a self-hosted backend platform and API gateway that bridges internal infrastructure with the outside world. It allows you to instantly expose legacy databases as REST APIs, orchestrate microservices, build custom business logic in PHP or JavaScript, and monetize APIs with subscription plans and automated billing. With native MCP support, Fusio connects your backend to AI ecosystems, enabling autonomous agents to use your APIs as tools. It also includes an automated developer portal, SDK generation, analytics, and monitoring. Deploy via Docker or manual setup.

Troubleshooting & FAQ (1)

Troubleshooting
How to fix Fusio `SQLSTATE[22001] value too long for type character varying(1023)` on a client_credentials token request?

This happens when no scope parameter is sent: Fusio inserts all scopes granted to the app as a comma-separated string into fusio_token.scope, which is limited to 1023 characters. Workaround: request only the required scopes explicitly, for example:

curl -X POST https://your-fusio/authorization/token \
  -u "APP_KEY:APP_SECRET" \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data 'grant_type=client_credentials&scope=backend.user,backend.action'

Also avoid assigning broad root scopes such as backend when narrower scopes such as backend.user are sufficient, because root scopes expand into many sub-scopes. Remove unused grants from the app/user.

For self-hosted PostgreSQL, the column can be widened manually if long scope lists are required:

ALTER TABLE fusio_token ALTER COLUMN scope TYPE TEXT;
ALTER TABLE fusio_app_code ALTER COLUMN scope TYPE TEXT;

Newer Fusio releases add an explicit exception when the scope string exceeds the column limit, making the cause clearer, but the immediate workaround is to send a shorter explicit scope or reduce granted scopes.

GitHub Issue #674

Tags

API管理API网关微服务数据库AI集成MCP开源

Getting Started

1

Download installer

Click the button above to download the installer for your system

2

Install the software

Double-click the downloaded installer and follow the prompts

3

Ensure Docker and docker-compose are installed

4

Create a docker-compose.yml file with the example from README (adjust database credentials and project key)

5

Run `docker compose up -d` to start the services

Install Guide
  1. Ensure Docker and docker-compose are installed
  2. Create a docker-compose.yml file with the example from README (adjust database credentials and project key)
  3. Run `docker compose up -d` to start the services
File Integrity

Checksum not available

This project has not published a SHA-256 checksum on its GitHub Release page

SHA256 Checksum

No checksum available

Download directly from GitHub Releases and verify file integrity yourself

All SHA-256 checksums on this platform are extracted from the project's official GitHub Release page, without any modification. You can independently verify them on the GitHub Releases page.

Open Source Transparency

View GitHub Source
Environment Guide

Uninstall Info

Stop containers with `docker compose down`, remove volumes if needed, or delete the project directory. For manual installations, remove the project folder and drop the database.

No Extra Dependencies

Ready to use after download. No additional runtime required.

Project Info
LicenseApache-2.0
Last Updated2026-10-15 06:13:20
GitHub RepositoryOfficial Website

Having issues? Check the FAQ below

1 FAQ

Similar Projects