Hoist

Self-hosted feature flag management with real-time updates and OpenFeature compatibility.

Hoist gives you complete control over your feature flags with a modern dashboard, real-time SDK updates, and enterprise features like targeting rules, scheduled rollouts, and audit logging.

Features

• Real-time updates - Flag changes propagate instantly via WebSocket streaming
• Multi-environment - Manage flags across development, staging, and production
• Targeting rules - Target users by attributes, segments, or percentage rollouts
• OpenFeature compatible - Use the industry-standard SDK interface
• Scheduled changes - Schedule flag changes for future deployment
• Audit logging - Track all changes for compliance
• Self-hosted - Keep your data on your infrastructure

Quick Start

# Start Hoist with Docker
docker compose up -d

# Open the dashboard
open http://localhost:4340

// Evaluate flags in your Go application
client, _ := hoist.NewClient(hoist.Config{
    APIKey:  "hoist_live_xxx",
    BaseURL: "http://localhost:4340",
})
defer client.Close()

enabled, _ := client.Bool(ctx, "new-feature", false, hoist.Context{
    TargetingKey: "user-123",
})

Documentation

Getting Started

• Getting Started - Quick start guide
• Installation - Detailed installation options
• Configuration - Full configuration reference

Concepts

• Core Concepts - Organizations, projects, environments, and flags

SDKs

• Go SDK - Native Go SDK with real-time streaming
• OpenFeature Provider - OpenFeature-compatible provider
• TypeScript SDK - TypeScript/JavaScript SDK

API Reference

• Authentication - JWT, API keys, and OAuth/OIDC
• REST API - API endpoint reference

Architecture

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Dashboard  │────▶│  API Server │────▶│  PostgreSQL │
└─────────────┘     └──────┬──────┘     └─────────────┘
                          │
                    ┌─────▼─────┐
                    │   Redis   │
                    └─────┬─────┘
                          │
┌─────────────┐     ┌─────▼─────┐
│    SDKs     │◀───▶│ WebSocket │
└─────────────┘     │    Hub    │
                    └───────────┘

Ports

Service	Port	Description
API Server	4340	REST API + Dashboard
PostgreSQL	5432	Primary database
Redis	6379	Cache + real-time

License

MIT License - see LICENSE for details.