Sign inSign up

predic8/membrane

By predic8

•Updated 12 days ago

Open-source API gateway for REST and SOAP: OpenAPI, OAuth2/JWT, WSDL-to-REST, AI/MCP gateway

Image
0

10K+

predic8/membrane repository overview

⁠Membrane API Gateway

Open-source API gateway that speaks both REST and SOAP.

GitHub release Docker Pulls License

Animated demo of Membrane API Gateway

Deploy APIs directly from OpenAPI, secure them with OAuth2 and JWT, or turn legacy SOAP web services into JSON APIs, all with a few lines of YAML. Lightweight, fast, and no database required.

⁠Quick Start

docker run --rm -it -p 2000:2000 predic8/membrane

Explore the sample APIs in your browser:

⁠Proxy Your First API

Create an apis.yaml file:

api:
  port: 2000
  target:
    url: https://apibin.io

Run a container with the file mounted:

Linux/macOS:

docker run --rm -p 2000:2000 -v "$(pwd)/apis.yaml:/opt/membrane/conf/apis.yaml" predic8/membrane

Windows PowerShell:

docker run --rm -p 2000:2000 -v "${PWD}/apis.yaml:/opt/membrane/conf/apis.yaml" predic8/membrane

Requests to http://localhost:2000⁠ are now forwarded to https://apibin.io⁠.

⁠Using the Image

ItemValue
Installation/opt/membrane
Configuration/opt/membrane/conf/apis.yaml (or proxies.xml)
Other config fileAppend -c <file> to docker run, e.g. ... predic8/membrane -c /config/my-apis.yaml
JVM optionsEnvironment variable JAVA_OPTS, e.g. -e JAVA_OPTS="-Xmx1g"
UserRuns as non-root user membrane (UID 1001)
Base imageEclipse Temurin JDK 25
Platformslinux/amd64, linux/arm64

Mount any files your configuration references (OpenAPI documents, WSDLs, keystores, ...) into the container as well, e.g. next to it in /opt/membrane/conf/.

⁠Tags
TagDescription
latestLatest stable release
7Latest release of major version 7
7.7Latest patch release of the 7.7 line
7.7.1A specific release

Pin a specific version in production. Images are signed with cosign⁠.

⁠Why Membrane

Native OpenAPI support – Deploy APIs from OpenAPI descriptions and validate requests and responses against them. Supports OpenAPI 3.0, 3.1, and 3.2.

Legacy XML and Web Services – Expose SOAP web services as JSON APIs without changing the backend. wsdl2openapi generates OpenAPI from WSDL and converts between JSON and XML. Use XPath and JSONPath for routing, filtering, and transformation.

Protect APIs and legacy services – Validate messages against OpenAPI, JSON Schema, XSD, and WSDL. Guard against malicious XML, JSON, JSON-RPC, and GraphQL payloads. Secure APIs with API keys, OAuth2, and JWT, and SOAP services with WS-Security, including XML signatures and encryption.

AI Gateway – Control which MCP tools clients may call, and centralize LLM provider keys with per-user token budgets and model restrictions.

API orchestration – Combine calls to multiple APIs in one flow with loops and conditions.

Simple configuration, flexible extensions – Configure routing, security, and transformations in YAML. For custom logic use Groovy, SpEL, JSONPath, XPath, or your own Java plugin.

Observability – Logging, Prometheus metrics, Grafana dashboards, and OpenTelemetry tracing.

⁠High Throughput, Small Footprint

Membrane stays fast with security and validation enabled. On a 16-vCPU Azure VM it achieved:

ConfigurationRequests/sec
Plain proxying216,000
Basic Auth + rate limiting + TLS196,000
OpenAPI validation of every request167,000

See the benchmark setup and results⁠.

⁠Documentation and Support

⁠License

Membrane API Gateway is licensed under the Apache License 2.0⁠.

Tag summary

Content type

Image

Digest

sha256:2e8c307c3…

Size

245.7 MB

Last updated

19 days ago

docker pull predic8/membrane