Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

grpc-wiremock

github.com

  • Free plan
  • Self-hosted
6.7 Club score Visit github.com

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.