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

Deployment Overview

Stitchd Feature Flag is designed for self-hosted deployment. The server is a single statically-linked Rust binary with two network interfaces: a REST API on HTTP and a gRPC server for SDK sync.

Prerequisites

DependencyMinimum VersionPurpose
PostgreSQL16+Feature flag config, tenants, RBAC, audit logs
ClickHouse24+Experiment events and metric aggregations (upcoming)
Rust toolchainstableBuilding from source

Quick Start

# 1. Start PostgreSQL
# 2. Set required environment variable
export DATABASE_URL="postgres://user:pass@localhost/stitchd"

# 3. Run migrations
sqlx migrate run --database-url "$DATABASE_URL"

# 4. Start the server
cargo run -p stitchd-server

The server starts on:

  • HTTP_PORT (default 8080) — REST Admin API
  • GRPC_PORT (default 9090) — SDK gRPC sync

Chapters