WireMock Hub

Features

🌐

Distributed WireMock Management

Deploy stubs to multiple WireMock instances at once. Sync all instances with a single click.

📈

Load Testing Optimized

Run multiple WireMock instances in parallel to easily build large-scale load testing environments.

💿

SQLite Persistence

No external database required. Simple file-based persistence makes backup easy.

📥

Request to Stub Import

Import recorded requests as stubs with one click. Quickly create stubs from actual API traffic.

🐳

Docker Support

Distributed as a Docker image. Start easily with docker compose up.

📚

Project Management

Manage stubs as projects for each environment: development, staging, production.

Architecture

┌─────────────────────────────────────────────────────────────────┐ │ WireMock Hub │ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │ │ Frontend │ -> │ Backend │ -> │ SQLite │ │ │ │ (Vue 3) │ │ (Fastify) │ │ (Persistence)│ │ │ └──────────────┘ └──────────────┘ └──────────────┘ │ └─────────────────────────────────────────────────────────────────┘ │ │ Sync ▼ ┌────────────────────┼────────────────────┐ │ │ │ ▼ ▼ ▼ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ WireMock │ │ WireMock │ │ WireMock │ │ Instance │ │ Instance │ │ Instance │ │ #1 │ │ #2 │ │ #3 │ └──────────┘ └──────────┘ └──────────┘

Quick Start

# Try with WireMock Hub + WireMock bundled image (Recommended)

docker run -d -p 3000:3000 ghcr.io/ykagano/wiremock-hub:latest

open http://localhost:3000/hub/

# WireMock instance URL (register after creating a project)

http://localhost:3000

# Try with WireMock Hub standalone image (connect to existing WireMock)

docker run -d -p 3000:3000 ghcr.io/ykagano/wiremock-hub-standalone:latest

open http://localhost:3000

Feature	WireMock Hub	WireMock	WireMock Cloud
GUI	✓	✕	✓
Distributed Instance Sync	✓	✕	✓
Request to Stub Import	✓	✕	✕
Open Source	✓	✓	✕
Self-hosted	✓	✓	✕
No External DB Required	✓	✓	-

How to Use

1 Register Projects and Instances

Create a project and add the WireMock instances you want to manage. Projects can be created for each environment (development, staging, production, etc.). Use health checks to verify the connection status of each instance.

2 Create Stub Mappings

Define request conditions and responses for the APIs you want to mock. You can configure detailed conditions such as URL patterns, HTTP methods, headers, and body. Created stubs are saved to SQLite and can be shared with your team.

3 Sync to All Instances

Click the "Sync All Instances" button to deploy created stubs to all registered WireMock instances at once. Instances are reset before syncing to ensure that SQLite and WireMock states are always consistent. You can view the recorded request logs on the screen after using the mock.