grpc-wiremock
grpc-wiremock is a free, open-source, self-hosted tool for mocking server APIs, including gRPC and protobuf services.
What grpc-wiremock is
grpc-wiremock is a free, open-source, self-hosted tool for mocking server APIs, including gRPC and protobuf services. It can create mocks from proto and OpenAPI files and reload them when contracts change. Multiple mock APIs can run at the same time, using additional ports such as 8001 and 8002. Built on WireMock, the project provides WireMock matchers and documents both a WireMock GUI and a Supervisor GUI for viewing status and API mocks. Its grpc2http command-line tool generates a runnable Go proxy project from proto contracts. That proxy translates gRPC requests into HTTP requests for WireMock and converts responses back to gRPC. The documented workflow uses the proto compiler together with Go gRPC and Go plugins. Quick-start deployment runs the service in Docker and mounts directories for mocks, certificates, and contracts. GitHub Actions builds images and uploads them to Docker Hub. grpc-wiremock is licensed under Apache License 2.0. The repository does not describe security certifications or compliance, and its comparison criteria remain marked TODO.
Good
- Generates mocks from proto and OpenAPI files
- Hot reloads when contracts change
- Runs multiple mock APIs concurrently
- Includes WireMock and Supervisor GUIs
- Free Apache License 2.0 project
Watch out
- Self-hosted deployment required
- No security certifications or compliance described
- Comparison criteria remain marked TODO
- Docker-based quick start requires mounted directories
Who it suits
It suits developers and teams testing microservices or gRPC contracts in self-hosted environments. It is relevant when Docker deployment, generated mocks, and WireMock-compatible matching are needed.
Verdict
grpc-wiremock focuses on contract-driven API mocking for gRPC and HTTP workflows. Its generated Go proxy, reload support, GUIs, and Docker image make it practical for self-hosted development, while security details are limited.
The facts
Each one read from grpc-wiremock's own pages, with the date it was checked.
What it does
- Availability
- The repository describes release automation that builds a Docker image and uploads it to Docker Hub.checked 4 Oct 2026
- Comparison
- The comparison document says its mock-server comparison criteria are still TODO.checked 4 Oct 2026
- Container deployment
- The quick-start instructions run grpc-wiremock as a Docker container and expose a Supervisor GUI and WireMock GUI.checked 8 Oct 2026
- Contract generation
- It can generate mocks from proto and OpenAPI files.checked 8 Oct 2026
- Deployment
- The quick-start instructions run grpc-wiremock as a Docker container and mount mock, certificate, and contract directories.checked 4 Oct 2026
- gRPC mocking
- It supports mocking gRPC (protobuf) APIs.checked 8 Oct 2026
- GUI
- The project says it inherits the WireMock GUI.checked 8 Oct 2026
- Hot reload
- It supports hot reload when contracts change.checked 8 Oct 2026
- Image availability
- The project’s README says GitHub Actions builds and uploads Docker images to Docker Hub.checked 8 Oct 2026
- Integration
- The project documents using proto compiler and Go gRPC and Go plugins to generate proxy code.checked 4 Oct 2026
- License
- The repository states that grpc-wiremock is licensed under Apache License 2.0.checked 8 Oct 2026
- Mock generation
- It can generate mocks from proto and OpenAPI files and reload them when contracts change.checked 4 Oct 2026
- Multiple APIs
- It supports running multiple APIs simultaneously.checked 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.checked 8 Oct 2026
- Purpose
- grpc-wiremock is a tool for mocking server APIs.checked 8 Oct 2026
- Security
- The README shows a certificate directory mounted into the container but does not describe security certifications or compliance.checked 4 Oct 2026
- Use case
- Docker Hub describes the image as a tool to simplify microservices testing.checked 8 Oct 2026
- WireMock
- The project is based on WireMock and says it provides WireMock’s matchers.checked 4 Oct 2026
- WireMock foundation
- The project is based on WireMock and says it provides WireMock matchers.checked 8 Oct 2026
Alternatives to grpc-wiremock
- 1
Kreya
Free planLinuxmacOSWindows7.1Free plan - 2
Bandura
Free planLinuxmacOSSelf-hostedWindows6.7$59 one-time - 3
grpcmd
Free planLinuxmacOSWindows6.7From $9 a year - 4
FintX
Free planLinuxmacOSWindows6.6Free plan - 5
grpcui
Free planWebLinuxmacOSSelf-hosted6.6Free plan - 6
protoc-gen-doc
Free planLinuxmacOSSelf-hostedWindows6.5Free plan