Otoroshi is a layer of lightweight api management on top of a modern http reverse proxy written in Scala and developped by the MAIF OSS team that can handle all the calls to and between your microservices without service locator and let you change configuration dynamicaly at runtime.

The Otoroshi is a large hairy monster that tends to lurk on the top of the torii gate in front of Shinto shrines. It’s a hostile creature, but also said to be the guardian of the shrine and is said to leap down from the top of the gate to devour those who approach the shrine for only self-serving purposes.


You can download the latest build of Otoroshi as a fat jar, as a zip package or as a docker image.

You can install and run Otoroshi with this little bash snippet

curl -L -o otoroshi.jar 'https://github.com/MAIF/otoroshi/releases/download/v16.18.4/otoroshi.jar'
java -jar otoroshi.jar

or using docker

docker run -p "8080:8080" maif/otoroshi:16.18.4

now open your browser to http://otoroshi.oto.tools:8080/, log in with the credential generated in the logs and explore by yourself, if you want better instructions, just go to the Quick Start or directly to the installation instructions



Join the Otoroshi server Discord


The sources of Otoroshi are available on Github.


You can find the official Otoroshi logo on GitHub. The Otoroshi logo has been created by François Galioto (@fgalioto)


Every release, along with the migration instructions, is documented on the Github Releases page. A condensed version of the changelog is available on github


The work on Otoroshi is funded by MAIF and Cloud APIM with the help of the community.


Otoroshi is Open Source and available under the Apache 2 License