RustMock

Lightning-fast API mock server built in Rust with beautiful React dashboard

~35MB Docker image | Blazing fast | Full OpenAPI support | Smart proxy mode

Quick Start

Docker:

docker run -p 8090:8090 ghcr.io/arthurkowalsky/rust-mock:latest

CLI (Cargo):

cargo install RustMock
mokku

Open http://localhost:8090 - done!

Features

• Blazing Fast - Built on Rust + Actix Web, ~35MB Docker image
• CLI & Docker - mokku command or Docker one-liner
• OpenAPI Support - Import/export specs, auto-generate endpoints
• React Dashboard - Beautiful UI for managing mocks and viewing logs
• Smart Proxy - Mix mocked endpoints with real API calls
• Request Logging - Monitor and inspect all incoming requests

CLI Reference

Installation

cargo install RustMock

Commands

Examples

# Start with custom port
mokku server -p 3000

# Start with proxy to production API
mokku --proxy https://api.production.com

# Import OpenAPI and start server
mokku import openapi.yaml --start --open

# Quick mock endpoint
mokku mock POST /api/users 201 '{"id": 1, "name": "John"}'

Global Flags

Docker

Basic Usage

docker run -p 8090:8090 ghcr.io/arthurkowalsky/rust-mock:latest

With OpenAPI Import

docker run -p 8090:8090 \
  -v $(pwd)/openapi.json:/app/openapi.json \
  -e OPENAPI_FILE=/app/openapi.json \
  ghcr.io/arthurkowalsky/rust-mock:latest

Docker Compose

version: '3'
services:
  rustmock:
    image: ghcr.io/arthurkowalsky/rust-mock:latest
    ports:
      - "8090:8090"
    volumes:
      - ./openapi.json:/app/openapi.json
    environment:
      - OPENAPI_FILE=/app/openapi.json
      - DEFAULT_PROXY_URL=https://api.production.com  # optional

API Reference

Add Endpoint

curl -X POST http://localhost:8090/__mock/endpoints \
  -H "Content-Type: application/json" \
  -d '{
    "method": "GET",
    "path": "/api/users",
    "response": [{"id": 1, "name": "John"}],
    "status": 200
  }'

Import OpenAPI

curl -X POST http://localhost:8090/__mock/import \
  -H "Content-Type: application/json" \
  -d '{"openapi_spec": <your-openapi-json>}'

Proxy Mode

Route unmocked requests to a real API:

# Via CLI
mokku --proxy https://api.production.com

# Via Docker
docker run -p 8090:8090 -e DEFAULT_PROXY_URL=https://api.production.com ghcr.io/arthurkowalsky/rust-mock:latest

# Via API
curl -X POST http://localhost:8090/__mock/proxy \
  -H "Content-Type: application/json" \
  -d '{"url": "https://api.production.com"}'

Mock specific endpoints while proxying the rest to production.

Full proxy documentation →

Configuration

CLI Arguments

Environment Variables

CLI arguments take precedence over environment variables.

Architecture

RustMock consists of:

• Backend: Rust + Actix Web for exceptional performance
• Frontend: React dashboard for intuitive management
• Features: Dynamic endpoints, OpenAPI validation, comprehensive logging

Why RustMock?

• Performance - Built on Rust's blazing-fast foundation
• Lightweight - ~35MB Docker image, minimal memory footprint
• Developer UX - Beautiful dashboard, intuitive CLI
• Zero config - Works out of the box

Contributing

1. Fork the repository
2. Create feature branch (git checkout -b feature/amazing)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push (git push origin feature/amazing)
5. Open Pull Request

License

MIT License - see LICENSE