Examples

Complete, production-ready configuration examples for common Sentinel use cases. Each example includes the full configuration file, setup instructions, and testing commands.

Quick Reference

Example	Use Case	Key Features
Simple Proxy	Basic reverse proxy	Single upstream, health checks
API Gateway	API management	Versioning, auth, rate limiting
API Validation	Schema validation	OpenAPI specs, JSON Schema, contract enforcement
Load Balancer	Traffic distribution	Multiple backends, algorithms
Traffic Mirroring	Canary deployments	Shadow traffic, safe testing, sampling
Static Site	File serving	Caching, compression, SPA
Microservices	Service mesh	Multi-service routing
Security	WAF + Auth	Agents, protection layers
Observability	Monitoring stack	Prometheus, Grafana, tracing
WebSocket	Real-time apps	WS proxying, inspection
AI Gateway	LLM API proxy	Prompt security, PII filtering

Getting Started

Each example follows this structure:

1. Overview - What the example demonstrates
2. Configuration - Complete sentinel.kdl file
3. Setup - How to run the example
4. Testing - Commands to verify it works
5. Customization - Common modifications

Running Examples

All examples assume Sentinel is installed:

# Install Sentinel
cargo install sentinel-proxy

# Run with a configuration
sentinel -c sentinel.kdl

For examples using agents, install the required agents first:

# Example: Install WAF and auth agents
cargo install sentinel-agent-waf sentinel-agent-auth

Example Files

All configuration files in these examples are available in the sentinel-examples repository:

git clone https://github.com/raskell-io/sentinel-examples
cd sentinel-examples