selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

growthbook logo

Self-host growthbook

v5.2.1

Warehouse-native feature flags, experimentation, analytics

ReleaseOpen CoreMIT
Docker ComposeCompose file & guide
docker compose up -d
Updated34 minutes ago
LanguageTypescript
Setup difficultyModerate
Stars
8 601
RAM
2GB
Ports
3000 (Frontend (Next.js)), 3100 (API (Express.js))
Requires
MongoDB
Docker
growthbook/growthbook

What is growthbook?

GrowthBook is a warehouse-native platform for feature flagging, experimentation, and product analytics. It consists of a Next.js frontend, Express.js API, and Python stats engine bundled in a single Docker image. Teams use it to manage feature flags with advanced targeting and gradual rollouts, run A/B tests with a sophisticated stats engine (CUPED, sequential, Bayesian, bandits), and build product analytics dashboards. It connects to many data sources including BigQuery, Snowflake, Databricks, ClickHouse, and Trino. The self-hosted version runs via Docker Compose or Kubernetes (Helm) and requires a MongoDB-compatible database. GrowthBook is open-core: most code is MIT-licensed while enterprise features (SSO, SCIM, audit logs, advanced permissions) require a commercial license. It provides 24+ SDKs for web, mobile, and server environments, a REST API, webhooks, and an MCP server for AI agents.

growthbook alternatives

All self-hosted alternatives to Statsig →

Should you self-host growthbook?

growthbook scores 71/100 on selfhost.directory (how scoring works) and ranks #3 of 8 in Feature Flags. It has 8 601 GitHub stars, +105 in the last 30 days.

It shipped 7 stable releases in the past year. The latest, v5.2.1, came out on 16 November 2026. New versions land roughly every 5 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Flagsmith (80/100, 7 332 stars). It scores higher overall, so compare the two before you pick. See growthbook vs Flagsmith side by side.

Features

  • 24+ SDKs
  • A/B Testing
  • AI Assistant
  • Feature Flags
  • File Uploads (Local/S3/GCS)
  • MCP Server
  • Multi-org Support
  • OpenTelemetry observability
  • Product Analytics
  • REST API
  • SQL-backed Metrics
  • SSO / OIDCRequires Enterprise license key
  • Warehouse Native
  • Webhooks

growthbook README

GrowthBook

Open Source Feature Flags, Experimentation, and Product Analytics

Build Status Release Join us on Slack

Create a free GrowthBook Cloud account to get started quickly.

Or run it yourself with:

How to install growthbook

Install growthbook with Docker Compose

Docker and Docker Compose installed
Environment variables
APP_ORIGIN, API_HOST, MONGODB_URI, JWT_SECRET, ENCRYPTION_KEY, NODE_ENV, EMAIL_*, UPLOAD_METHOD, S3_*, OPENAI_API_KEY, ANTHROPIC_API_KEY, SSO_CONFIG, LICENSE_KEY, WEBHOOK_PROXY, LOG_LEVEL, TRACING_PROVIDER, DISABLE_TELEMETRY
git clone https://github.com/growthbook/growthbook.git
cd growthbook
docker compose up -d

Then visit http://localhost:3000

Uses prebuilt public Docker image from Docker Hub

How to configure growthbook

  • MONGODB_URIFull MongoDB connection string

    values: MongoDB connection string

  • NODE_ENVNode environment

    values: production, development

  • JWT_SECRETAuth signing key

    values: long random string

  • ENCRYPTION_KEYData source credential encryption key

    values: long random string

  • EMAIL_ENABLEDEnable email sending

    values: true, false

growthbook releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

FAQ

Can I use Azure CosmosDB instead of MongoDB?

No. Azure Cosmos DB is not fully supported as a MongoDB replacement for GrowthBook. Use Azure DocumentDB instead.

What are the hardware requirements for self-hosting GrowthBook?

The application is very lightweight. For most use cases, 2GB of memory is sufficient even for large production deployments. GrowthBook only deals with aggregate data and offloads bulk processing to your data source.

Which docker image tag should I use when self-hosting?

Use the latest tag for both dev and production self-hosted deployments. It represents the latest stable build and is what the Cloud app uses. Update regularly by pulling the latest image.

How do I run an A/B test in GrowthBook?

Create a feature in GrowthBook with an A/B Experiment rule, then use the SDKs to serve different variations based on the feature flag.

What do I use for an "id" attribute in the SDK if my users aren't logged in?

Use a deviceId or sessionId - a random anonymous hash persisted in a cookie or local storage. For apps with both logged-in and anonymous users, use two identifier attributes: id for logged-in users and deviceId for all users.

Do users always get assigned the same experiment variation?

GrowthBook SDKs use deterministic hashing to ensure the same user always gets assigned the same variation in an experiment. Changing the traffic split between variations may cause some users to switch variations.

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…