Skip to content
Back to search

fusio

Self-Hosted API Management for Builders

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/apioo/fusio with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/apioo/fusio'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/apioo--fusio/badge.svg)](/listings/apioo--fusio)

HTML

<a href="/listings/apioo--fusio"><img src="/api/listings/apioo--fusio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

🐳 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](https://docs.fusio-project.org/docs/bootstrap) guide

πŸ› οΈ Manual Installation

* __Download artifact__

You can either download the official [release](https://github.com/apioo/fusio/releases) 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](https://docs.fusio-project.org/docs/installation/) 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md Β· README Β· 357 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <a href="https://www.fusio-project.org/" target="_blank">
  3. <img src="https://www.fusio-project.org/img/fusio_64px.png" width="64">
  4. </a>
  5. </p>
  6. <h1 align="center">Fusio</h1>
  7. <p align="center">
  8. <strong>Open Source API Management Platform</strong><br />
  9. Turn your business logic into scalable API products for humans and AI agents.
  10. </p>
  11. <p align="center">
  12. <a href="https://docs.fusio-project.org/">πŸ“– Documentation</a> β€’
  13. <a href="https://www.youtube.com/watch?v=U7QYGKknw_Q">πŸ“Ί Video Walkthrough (15m)</a> β€’
  14. <a href="https://discord.gg/eMrMgwsc6e">πŸ’¬ Discord Community</a>
  15. </p>
  16. ---
  17. Fusio is a self-hosted, open-source backend platform and API gateway written in PHP that bridges the gap between your
  18. internal infrastructure and the outside world. Whether you are exposing legacy databases, orchestrating microservices,
  19. or building custom business logic, Fusio handles the heavy lifting. It transforms your services into a professional API
  20. product, complete with an automated developer portal, SDK generation, and monetization tools. With native MCP support,
  21. Fusio also acts as a bridge to the AI ecosystem, allowing you to turn your backend logic into tools for autonomous
  22. agents.
  23. ## πŸš€ Features
  24. * **Database API Gateway** - Instantly expose legacy SQL/NoSQL databases (MySQL, PostgreSQL, etc.) as REST APIs.
  25. * **Microservice Gateway** - Securely route, orchestrate, and load-balance traffic between your distributed services.
  26. * **Custom API Logic** - Build powerful backend logic using reusable actions in PHP or Javascript.
  27. * **Agent Development** - Use your custom API logic as "Tools" to build and power autonomous AI agents.
  28. * **AI-Assisted Development** - Generate custom backend logic and schemas using natural language prompts.
  29. * **MCP Integration** - Native support for the Model Context Protocol to expose APIs to AI ecosystems.
  30. * **API Developer Portal** - A self-service portal for third-party developers with docs, testing tools, and keys.
  31. * **SDK Automation** - Zero-effort generation of client SDKs for all major programming languages.
  32. * **API Monetization** - Turn your API into a product with subscription plans, quotas, and automated billing.
  33. * **Analytics & Monitoring** - Real-time tracking of API usage, performance metrics, and error logging.
  34. ## πŸ“¦ Installation
  35. ### 🐳 Docker
  36. The fastest way to try Fusio locally is with Docker and docker-compose.
  37. ```yaml
  38. services:
  39. fusio:
  40. image: fusio/fusio
  41. restart: always
  42. environment:
  43. FUSIO_PROJECT_KEY: "42eec18ffdbffc9fda6110dcc705d6ce"
  44. FUSIO_CONNECTION: "pdo-mysql://fusio:61ad6c605975@mysql-fusio/fusio"
  45. FUSIO_BACKEND_USER: "test"
  46. FUSIO_BACKEND_EMAIL: "demo@fusio-project.org"
  47. FUSIO_BACKEND_PW: "test1234"
  48. ports:
  49. - "8080:80"
  50. mysql-fusio:
  51. image: mysql:8.0
  52. restart: always
  53. environment:
  54. MYSQL_RANDOM_ROOT_PASSWORD: "1"
  55. MYSQL_USER: "fusio"
  56. MYSQL_PASSWORD: "61ad6c605975"
  57. MYSQL_DATABASE: "fusio"
  58. volumes:
  59. - ./db:/var/lib/mysql
  60. ```
  61. > docker compose up -d
  62. **After startup**
  63. * Backend: http://localhost:8080/apps/fusio
  64. * Login with the credentials you configured
  65. * For the first steps, take a look at our [Getting Started](https://docs.fusio-project.org/docs/bootstrap) guide
  66. ### πŸ› οΈ Manual Installation
  67. * __Download artifact__
  68. You can either download the official [release](https://github.com/apioo/fusio/releases) or clone the repository.
  69. ```bash
  70. git clone https://github.com/apioo/fusio.git
  71. ```
  72. * __Configure `.env`__
  73. Configure fitting database credentials at the `APP_CONNECTION` variable, all other parameters are optional.
  74. ```bash
  75. APP_CONNECTION=pdo-mysql://root:password@localhost/fusio
  76. APP_URL=http://localhost:8080
  77. ```
  78. > It is also recommended to provide the `APP_URL` which contains the domain pointing to the public folder i.e.
  79. `https://api.my_domain.com` or `https://my_domain.com/fusio`, this is required if you host Fusio inside
  80. a sub-folder otherwise Fusio tries to detect the domain via the Host header.
  81. Supported DBs:
  82. * MySQL: `pdo-mysql://user:pass@host/db`
  83. * PostgreSQL: `pdo-pgsql://user:pass@host/db`
  84. * SQLite: `pdo-sqlite:///fusio.sqlite`
  85. * __Run migrations__
  86. ```bash
  87. php bin/fusio migrate
  88. ```
  89. * __Create administrator user__
  90. ```bash
  91. php bin/fusio adduser
  92. ```
  93. > Choose Administrator as account type.
  94. * __Install backend app__
  95. ```bash
  96. php bin/fusio marketplace:install fusio
  97. ```
  98. * __Start server (dev only)__
  99. ```bash
  100. php -S 127.0.0.1:8080 -t public
  101. ```
  102. > 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](https://docs.fusio-project.org/docs/installation/) for more details.
  103. ### 🌐 Web-Installer
  104. Instead of manual installation you can also use the web installer script located at `/install.php`
  105. to complete the installation. After installation, it is recommended to delete this "install" script.
  106. ## 🧭 Getting Started
  107. Use our [Getting Started](https://docs.fusio-project.org/docs/bootstrap) guide to build your first action and configure
  108. an operation to expose the action as API endpoint.
  109. ### Action
  110. At the core of Fusio, you describe your business logic in an Action. An Action is a PHP class that receives an incoming
  111. request and returns a response.
  112. ```php
  113. <?php
  114. namespace App\Action;
  115. use Fusio\Engine;
  116. class MyAction implements Engine\ActionInterface
  117. {
  118. public function handle(Engine\RequestInterface $request, Engine\ParametersInterface $configuration, Engine\ContextInterface $context): mixed
  119. {
  120. return [
  121. 'hello' => 'world'
  122. ];
  123. }
  124. }
  125. ```
  126. Once defined, this action can be bound to an Operation so that it executes for a specific HTTP method and path.
  127. #### Configuration
  128. Fusio allows you to build actions that are configurable directly from the backend. In the example below, we add a
  129. `message` configuration parameter so a user can customize the response without changing the code.
  130. ```php
  131. <?php
  132. namespace App\Action;
  133. use Fusio\Engine;
  134. class MyAction extends Engine\ActionAbstract
  135. {
  136. public function handle(Engine\RequestInterface $request, Engine\ParametersInterface $configuration, Engine\ContextInterface $context): mixed
  137. {
  138. return [
  139. 'hello' => $configuration->get('message'),
  140. ];
  141. }
  142. public function configure(Engine\Form\BuilderInterface $builder, Engine\Form\ElementFactoryInterface $elementFactory): void
  143. {
  144. $builder->add($elementFactory->newInput('message', 'Message', 'text', 'The message which should be returned'));
  145. }
  146. }
  147. ```
  148. In the backend, this parameter is now exposed via a generated form:
  149. ![Action_Configuration](https://www.fusio-project.org/media/backend/action_configuration.png)
  150. This concept makes actions highly reusable for both developers and non-technical users. We also provide a
  151. [preset of actions](https://docs.fusio-project.org/docs/backend/api/action/) for common tasks. If you build an action
  152. you'd like to share, check out our [Adapter](https://www.fusio-project.org/adapter) page. See our
  153. [custom action](https://docs.fusio-project.org/docs/development/custom_action) documentation for more details.
  154. #### Worker
  155. Fusio provides Worker actions, which allow you to develop logic directly in the backend without building custom PHP
  156. classes.
  157. ![Worker_PHP_Designer](https://www.fusio-project.org/media/backend/worker_php_designer.png)
  158. This also enables you to build actions in other languages like JavaScript or Python, which is ideal if your team is more
  159. familiar with those ecosystems. Learn more in the [worker documentation](https://docs.fusio-project.org/docs/action/worker).
  160. #### AI
  161. With the 7.0 release, we introduced a new Agent concept that allows you to generate worker actions using AI.
  162. ![Agent_Message](https://www.fusio-project.org/media/backend/agent_message.png)
  163. This makes developing backend logic accessible to everyone. Simply describe the logic you need:
  164. > return a list of popular composers of the 19th century
  165. The Agent then generates the appropriate action logic automatically. Fusio supports multiple providers, including
  166. Ollama, ChatGPT, and Gemini, so you are never locked into a specific AI. Explore the AI
  167. [agent documentation](https://docs.fusio-project.org/docs/ai/) for more.
  168. ## 🧩 Apps
  169. Fusio includes a flexible app system that lets you install various web-based apps to support different API-related use
  170. cases. These apps are typically simple JavaScript frontends that interact with Fusio's internal API.
  171. You can browse all available apps in the [Fusio Marketplace](https://www.fusio-project.org/marketplace),
  172. and install them using either the CLI:
  173. ```bash
  174. php bin/fusio marketplace:install fusio
  175. ```
  176. or directly through the backend interface.
  177. ### πŸ–₯️ Backend
  178. ![Backend](https://www.fusio-project.org/media/backend/dashboard.png)
  179. The backend app is the main app to configure and manage your API located at `/apps/fusio/`.
  180. ### πŸ’‘ VSCode
  181. Fusio provides a [VSCode extension](https://marketplace.visualstudio.com/items?itemName=Fusio.fusio)
  182. which can be used to simplify action development.
  183. ## πŸ”— Integration
  184. ### 🧰 SDK
  185. To build and integrate applications with Fusio, you can use one of our officially supported SDKs, which simplify
  186. interaction with a Fusio instance. Alternatively, you can directly communicate with the REST API for full control and
  187. flexibility.
  188. | Language | GitHub | Package | Example |
  189. |----------------|---------------------------------------------------------|--------------------------------------------------------------------|-------------------------------------------------------------|
  190. | __C#__ | [GitHub](https://github.com/apioo/fusio-sdk-csharp) | [NuGet](https://www.nuget.org/packages/Fusio.SDK) | [Example](https://github.com/apioo/fusio-sample-csharp-cli) |
  191. | __Go__ | [GitHub](https://github.com/apioo/fusio-sdk-go) | [go get](https://github.com/apioo/fusio-sdk-go) | [Example](https://github.com/apioo/fusio-sample-go-cli) |
  192. | __Java__ | [GitHub](https://github.com/apioo/fusio-sdk-java) | [Maven](https://mvnrepository.com/artifact/org.fusio-project/sdk) | [Example](https://github.com/apioo/fusio-sample-java-cli) |
  193. | __Javascript__ | [GitHub](https://github.com/apioo/fusio-sdk-javascript) | [NPM](https://www.npmjs.com/package/fusio-sdk) | |
  194. | __PHP__ | [GitHub](https://github.com/apioo/fusio-sdk-php) | [Packagist](https://packagist.org/packages/fusio/sdk) | [Example](https://github.com/apioo/fusio-sample-php-cli) |
  195. | __Python__ | [GitHub](https://github.com/apioo/fusio-sdk-python) | [PyPI](https://pypi.org/project/fusio-sdk/) | [Example](https://github.com/apioo/fusio-sample-python-cli) |
  196. ### πŸ–₯️ Frontend
  197. | Framework | GitHub | Package | Example |
  198. |-----------|------------------------------------------------------------------|-----------------------------------------------------|---------|
  199. | Angular | [GitHub](https://github.com/apioo/fusio-sdk-javascript-angular) | [NPM](https://www.npmjs.com/package/ngx-fusio-sdk) | [Example](https://github.com/apioo/fusio-sample-javascript-angular) |
  200. ### πŸ“‘ REST API
  201. | Domain | Documentation | Specification |
  202. |----------|-----------------------------------------------------|-----------------------------------------------------------------------------------------|
  203. | Backend | [ReDoc](https://www.fusio-project.org/api/backend) | [OpenAPI](https://demo.fusio-project.org/system/generator/spec-openapi?filter=backend) |
  204. | Consumer | [ReDoc](https://www.fusio-project.org/api/consumer) | [OpenAPI](https://demo.fusio-project.org/system/generator/spec-openapi?filter=consumer) |
  205. | System | [ReDoc](https://www.fusio-project.org/api/system) | [OpenAPI](https://demo.fusio-project.org/system/generator/spec-openapi?filter=system) |
  206. ## 🌍 Ecosystem
  207. Besides our core product, we offer additional services to augment the functionality of Fusio.
  208. * [Marketplace](https://www.fusio-project.org/marketplace)
  209. The Fusio marketplace is the place to share apps and actions with other Fusio users, it helps to quickly build your
  210. API by using existing code from other users. You can register and configure the credentials at your local Fusio
  211. installation under System / Config s. `marketplace_client_id` and `marketplace_client_secret` then you can use the
  212. panel under Development / Marketplace to install apps or actions.
  213. * [SDKgen](https://sdkgen.app/)
  214. SDK as a service platform which helps you to generate client SDKs for your API in different languages like `CSharp`,
  215. `Go`, `Java` and `Python` which helps your customers to interact with your API. Therefor you need to register at the
  216. SDKgen app and provide the credentials under System / Config s. `sdkgen_client_id` and `sdkgen_client_secret`.
  217. Then you can generate the SDK directly at the backend under Development / SDK.
  218. * [TypeHub](https://typehub.cloud/)
  219. API and data design platform, basically you can push your API specification to this platform so that users can simply
  220. discover your API. It tracks all changes of your API so that you have always a clean history how your API evolves.
  221. * [APIgen](https://apigen.app/)
  222. Service which generates fully working Fusio APIs based on a data model. It also includes a simple Angular frontend app
  223. to CRUD your models. It can be seen as low-code generator to quickly generate CRUD APIs but the generated code is
  224. clean and can be also used as foundation for your next app.
  225. * [APImon](https://apimon.app/)
  226. Simple API monitoring service which helps to monitor your Fusio installation. It is optimized for Fusio, but it can be
  227. also used for different API endpoints. APImon invokes your endpoints in specific intervals and notifies you about
  228. changes. It also includes an uptime page for your users for example s. https://api.apimon.app/status/fusio_marketplace
  229. ## 🏷️ Domains
  230. By default, the entire Fusio project can be hosted on a single domain. In this setup:
  231. * Your API is served from the root path (e.g., https://acme.com/).
  232. * Web apps like the developer portal and admin backend are accessible under the `/apps` directory (e.g., https://acme.com/apps/developer).
  233. This setup is quick to get started with and requires no additional configuration. For production environments, we
  234. recommend a subdomain-based structure:
  235. * __api.acme.com__
  236. Hosts only the Fusio API. In this setup, you can safely remove the `apps/` folder from the `public/` directory.
  237. * __developer.acme.com__
  238. Hosts the **Developer App**, a portal where third-party developers can register, view documentation, and access their credentials.
  239. * __fusio.acme.com__ (optional)
  240. Hosts the **Backend App**, used to manage your Fusio instance. You can also host this on a separate internal domain.
  241. > Note: This is just a suggested setup. You're free to choose any domain or subdomain structure that best fits your infrastructure.
  242. ## πŸ“š Documentation
  243. Please check out our official documentation website where we bundle all documentation resources:
  244. https://docs.fusio-project.org/
  245. ## 🀝 Support & Community
  246. If you have questions, found a bug, or want to share your feedback, we are active across the following channels:
  247. * **[GitHub Discussions](https://github.com/apioo/fusio/discussions)** - Best for "How-to" questions, architectural feedback, and sharing feature ideas.
  248. * **[Discord Community](https://discord.gg/eMrMgwsc6e)** - Join our real-time chat to connect with other Fusio developers and the core maintainers.
  249. * **[Issue Tracker](https://github.com/apioo/fusio/issues)** - Report technical bugs or reproducible errors. Please check the **[Documentation](https://docs.fusio-project.org/)** first.
  250. * **[Direct Contact](https://www.fusio-project.org/contact)** - Reach out via our official website for specific inquiries or high-level feedback.
  251. ## 🀝 Partners
  252. We're grateful to our partners who support the Fusio project and share our vision of advancing open API development.
  253. If your company is interested in becoming a partner and being listed here, consider [becoming a sponsor](https://github.com/sponsors/chriskapp).
  254. <a href="https://jb.gg/OpenSource">
  255. <picture>
  256. <source media="(prefers-color-scheme: dark)" srcset="https://www.jetbrains.com/company/brand/img/logo_jb_dos_3.svg">
  257. <source media="(prefers-color-scheme: light)" srcset="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg">
  258. <img alt="JetBrains logo." src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg">
  259. </picture>
  260. </a>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.