Open-source API gateway for REST and SOAP: OpenAPI, OAuth2/JWT, WSDL-to-REST, AI/MCP gateway
10K+
Open-source API gateway that speaks both REST and SOAP.
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.
docker run --rm -it -p 2000:2000 predic8/membrane
Explore the sample APIs in your browser:
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.
| Item | Value |
|---|---|
| Installation | /opt/membrane |
| Configuration | /opt/membrane/conf/apis.yaml (or proxies.xml) |
| Other config file | Append -c <file> to docker run, e.g. ... predic8/membrane -c /config/my-apis.yaml |
| JVM options | Environment variable JAVA_OPTS, e.g. -e JAVA_OPTS="-Xmx1g" |
| User | Runs as non-root user membrane (UID 1001) |
| Base image | Eclipse Temurin JDK 25 |
| Platforms | linux/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/.
| Tag | Description |
|---|---|
latest | Latest stable release |
7 | Latest release of major version 7 |
7.7 | Latest patch release of the 7.7 line |
7.7.1 | A specific release |
Pin a specific version in production. Images are signed with cosign.
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.
Membrane stays fast with security and validation enabled. On a 16-vCPU Azure VM it achieved:
| Configuration | Requests/sec |
|---|---|
| Plain proxying | 216,000 |
| Basic Auth + rate limiting + TLS | 196,000 |
| OpenAPI validation of every request | 167,000 |
See the benchmark setup and results.
Membrane API Gateway is licensed under the Apache License 2.0.
Content type
Image
Digest
sha256:2e8c307c3…
Size
245.7 MB
Last updated
19 days ago
docker pull predic8/membrane