Running the Proxy

Basic Usage

# Run with default config location
cargo run -p meridian-proxy -- meridian-proxy/meridian.toml

# Run the release binary directly
./target/release/meridian meridian-proxy/meridian.toml

Meridian logs to stderr using structured logging via tracing. Control log level with the RUST_LOG environment variable:

# Info level (default)
RUST_LOG=info ./target/release/meridian config.toml

# Debug level (verbose)
RUST_LOG=debug ./target/release/meridian config.toml

# Trace level (very verbose)
RUST_LOG=trace ./target/release/meridian config.toml

# Component-specific
RUST_LOG=meridian_proxy::connection=debug ./target/release/meridian config.toml

Shutdown

Meridian shuts down gracefully on Ctrl+C (SIGINT). Active connections are drained before the process exits.

Ports

The configuration file specifies which ports Meridian listens on. Common setups:

Health Check

Once running, verify with:

# If admin API is configured
curl http://localhost:9901/ready
# Returns: LIVE

# If proxying to a backend
curl http://localhost:8080/