grpc-wiremock

What grpc-wiremock is
grpc-wiremock is a free, self-hosted mock server for APIs, including gRPC (protobuf) services. It generates mocks from proto and OpenAPI files and can reload them when those contracts change. Multiple mock APIs can run at once, with additional APIs using ports such as 8001 and 8002. The project is built on WireMock and says it provides WireMock matchers; it also documents a WireMock GUI and a Supervisor GUI for viewing status and API mocks. For gRPC workflows, its grpc2http command-line tool generates a runnable Go proxy project from proto contracts. The proxy translates gRPC requests into HTTP requests for WireMock and converts responses back to gRPC. The documented code-generation workflow uses the proto compiler and Go gRPC and Go plugins. Quick-start instructions run the service in a Docker container and mount directories for mocks, certificates and contracts. The repository states that the project uses the Apache License 2.0, and release automation builds Docker images and uploads them to Docker Hub. Docker Hub describes the image as a tool for simplifying microservices testing.
Who it suits
It suits developers who need self-hosted mocks for gRPC or other APIs, especially where proto or OpenAPI contracts change. Its Docker-based workflow and Go proxy generator are relevant to teams using those tools.
What it does well
- Generates mocks from proto and OpenAPI files.
- Reloads mocks when contracts change.
- Runs multiple mock APIs simultaneously.
- Includes WireMock matchers and documented GUIs.
- Free and licensed under Apache License 2.0.
What to know first
- Self-hosted deployment uses a Docker container.
- The documented proxy-generation workflow uses Go plugins.
- The comparison document's criteria are still marked TODO.
Verdict
grpc-wiremock provides contract-based mock generation, hot reload and a gRPC-to-HTTP proxy workflow in a self-hosted package. Its documented setup depends on Docker, and the repository does not describe security certifications or compliance.
Facts from grpc-wiremock's own pages
- Availability
- The repository describes release automation that builds a Docker image and uploads it to Docker Hub. · github.com, 4 Oct 2026
- Comparison
- The comparison document says its mock-server comparison criteria are still TODO. · github.com, 4 Oct 2026
- Container deployment
- The quick-start instructions run grpc-wiremock as a Docker container and expose a Supervisor GUI and WireMock GUI. · github.com, 8 Oct 2026
- Contract generation
- It can generate mocks from proto and OpenAPI files. · github.com, 8 Oct 2026
- Deployment
- The quick-start instructions run grpc-wiremock as a Docker container and mount mock, certificate, and contract directories. · github.com, 4 Oct 2026
- gRPC mocking
- It supports mocking gRPC (protobuf) APIs. · github.com, 8 Oct 2026
- GUI
- The project says it inherits the WireMock GUI. · github.com, 8 Oct 2026
- Hot reload
- It supports hot reload when contracts change. · github.com, 8 Oct 2026
- Image availability
- The project’s README says GitHub Actions builds and uploads Docker images to Docker Hub. · github.com, 8 Oct 2026
- Integration
- The project documents using proto compiler and Go gRPC and Go plugins to generate proxy code. · github.com, 4 Oct 2026
- License
- The repository states that grpc-wiremock is licensed under Apache License 2.0. · github.com, 8 Oct 2026
- Mock generation
- It can generate mocks from proto and OpenAPI files and reload them when contracts change. · github.com, 4 Oct 2026
- Multiple APIs
- It supports running multiple APIs simultaneously. · github.com, 8 Oct 2026
- 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. · github.com, 8 Oct 2026
- Purpose
- grpc-wiremock is a tool for mocking server APIs. · github.com, 8 Oct 2026
- Security
- The README shows a certificate directory mounted into the container but does not describe security certifications or compliance. · github.com, 4 Oct 2026
- Use case
- Docker Hub describes the image as a tool to simplify microservices testing. · hub.docker.com, 8 Oct 2026
- WireMock
- The project is based on WireMock and says it provides WireMock’s matchers. · github.com, 4 Oct 2026
- WireMock foundation
- The project is based on WireMock and says it provides WireMock matchers. · github.com, 8 Oct 2026
Where grpc-wiremock stands on Freedom251
- gRPC Tools#22 of 24