WireMock Hub

Features

🔄

Visual Stub Editor & Sync

Create and edit stubs with a form-based UI. Deploy to all instances with a single click via Sync or Append mode.

🔗

Scenario Management

Build stateful stub chains with a visual editor. Drag-and-drop reordering and inline state editing with automatic propagation.

📊

Request Log & Recording

Browse request logs with filtering. Start/stop proxy recording on any instance. Convert logged requests into stubs.

🔍

Registered Stubs View

View stubs registered on each WireMock instance. Distinguish Hub-created stubs from external ones. Delete individual or all mappings.

📥

Import / Export

Import stubs from JSON files or export for sharing. Clone existing stubs or entire projects to set up new environments quickly.

🎨

SQLite & Modern UI

File-based SQLite persistence with no external database. Dark/Light/System themes and English/Japanese support.

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	✓	✕	✓
Visual Scenario Editor	✓	✕	✕
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. Configure URL patterns, HTTP methods, headers, query parameters, and body matching. Import stubs from JSON files or clone existing ones.

3 Build Scenario Chains

For stateful APIs, use the Scenario editor to build state chains visually. Reorder steps with drag-and-drop, edit state names inline with automatic propagation to adjacent steps.

4 Sync & Monitor

Click "Sync All Instances" to deploy stubs to all WireMock instances at once. View request logs to verify mock behavior, filter by URL/method/status, and start proxy recording to capture live traffic.