grpc-wiremock
github.com
- Free plan
- Self-hosted
What grpc-wiremock is
grpc-wiremock is a free, open-source self-hosted tool for mocking server APIs, including gRPC and protobuf services. It generates mocks from proto or OpenAPI files and can reload them when contracts change. Multiple mock APIs can run simultaneously on additional ports such as 8001 and 8002. Based on WireMock, the project provides WireMock matchers and documents both a WireMock GUI and a Supervisor GUI for viewing status and mocks. Its grpc2http command-line tool creates a runnable Go proxy project from proto contracts; the proxy translates gRPC requests into HTTP requests for WireMock and converts responses back to gRPC. Quick-start deployment uses Docker with mounted mock, certificate, and contract directories. Release automation builds Docker images and uploads them to Docker Hub. The repository is licensed under Apache License 2.0.
Who it suits
It suits teams that need self-hosted API mocks for microservices or gRPC development. Users should be comfortable with Docker, proto tooling, and Go plugins.
Good to know, and what to watch
- Generates mocks from proto and OpenAPI
- Hot reload when contracts change
- Runs multiple mock APIs
- WireMock matchers and GUIs
- Apache License 2.0
- Self-hosted deployment required
- Comparison criteria remain marked TODO
- No security certification or compliance stated
The verdict
grpc-wiremock focuses on contract-driven mocks with gRPC-to-HTTP proxy generation and Docker deployment. Its free Apache-licensed model fits teams that can operate the service themselves.
What the maker publishes
- Availability
- The repository describes release automation that builds a Docker image and uploads it to Docker Hub. source
- Comparison
- The comparison document says its mock-server comparison criteria are still TODO. source
- Container deployment
- The quick-start instructions run grpc-wiremock as a Docker container and expose a Supervisor GUI and WireMock GUI. source
- Contract generation
- It can generate mocks from proto and OpenAPI files. source
- Deployment
- The quick-start instructions run grpc-wiremock as a Docker container and mount mock, certificate, and contract directories. source
- gRPC mocking
- It supports mocking gRPC (protobuf) APIs. source
- GUI
- The project says it inherits a WireMock GUI and documents a Supervisor GUI for viewing status and API mocks. source
- GUI
- The project says it inherits the WireMock GUI. source
- Hot reload
- It supports hot reload when contracts change. source
- Image availability
- The project’s README says GitHub Actions builds and uploads Docker images to Docker Hub. source
- Integration
- The project documents using proto compiler and Go gRPC and Go plugins to generate proxy code. source
- License
- The repository states grpc-wiremock is licensed under Apache License 2.0. source
- License
- The repository states that grpc-wiremock is licensed under Apache License 2.0. source
- Mock generation
- It can generate mocks from proto and OpenAPI files and reload them when contracts change. source
- Multiple APIs
- It supports running multiple mock APIs at the same time, with additional APIs using ports such as 8001 and 8002. source
- Multiple APIs
- It supports running multiple APIs simultaneously. source
- Proxy generator
- Its grpc2http CLI generates a runnable Go proxy project from proto contracts, converting gRPC requests to HTTP requests for WireMock and converting responses back to gRPC. source
- Proxy generator
- The grpc2http CLI generates a runnable Go proxy project from proto contracts, converting gRPC requests to HTTP requests for WireMock and converting responses back to gRPC. source
- Purpose
- grpc-wiremock is a tool for mocking server APIs, including gRPC APIs. source
- Purpose
- grpc-wiremock is a tool for mocking server APIs. source
- Security
- The README shows a certificate directory mounted into the container but does not describe security certifications or compliance. source
- Use case
- Docker Hub describes the image as a tool to simplify microservices testing. source
- WireMock
- The project is based on WireMock and says it provides WireMock’s matchers. source
- WireMock foundation
- The project is based on WireMock and says it provides WireMock matchers. source
Checked against the maker's pages on 8 Oct 2026.