Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Getting Started

To get started with Molock, you’ll need to install the project and run the server.

Prerequisites

  • Rust: Version 1.70 or higher.
  • Docker & Docker Compose: For running the observability stack (Jaeger, Prometheus, Grafana).
  • Make: (Optional) For using the provided shortcuts in the Makefile.

Installation

# Clone the repository
git clone https://github.com/fike/molock.git
cd molock

# Build the project
make build

# Run tests
make test

# Start the server with default configuration
make run

Immediate Usage

Once the server is running, you can test it with curl:

# Health check (with dynamic timestamp)
curl http://localhost:8080/health

# Path parameter matching
curl http://localhost:8080/users/123

# Regex/Condition matching (triggers 404 if not found)
curl http://localhost:8080/users/unknown