unleash README

The project's README from github.com/Unleash/unleash. As one markdown file: README.md.

Visit the Unleash website

Build and Tests Coverage Report Docker Pulls AGPL-3.0-or-later license Join Unleash on Slack

Launch the live demo | Try Unleash Enterprise for free

What is Unleash?

Unleash is a powerful open-source solution for feature management. It streamlines your development workflow, accelerates software delivery, and empowers teams to control how and when they roll out new features to end users. With Unleash, you can deploy code to production in smaller, more manageable releases at your own pace.

Feature flags in Unleash let you test your code with real production data, reducing the risk of negatively impacting your users' experience. It also enables your team to work on multiple features simultaneously without the need for separate feature branches.

Unleash is the most popular open-source solution for feature flagging on GitHub. It supports 15 official client and server SDKs and over 15 community SDKs. You can even create your own SDK if you wish. Unleash is compatible with any language and framework.


Get started with Unleash

Set up Unleash

To get started with Unleash, you can either explore Unleash Enterprise with a free trial or get started locally with our open-source solution.

Unleash Enterprise

To start with Unleash Enterprise, request a free trial. This gives you access to a hosted instance with unlimited projects and environments and features such as role-based access control, change requests, single sign-on, and SCIM for automatic user provisioning.

Unleash Open Source

To set up Unleash locally, you'll need git and docker installed on your machine.

Execute the following commands:

git clone [email protected]:Unleash/unleash.git
cd unleash
docker compose up -d

Then point your browser to localhost:4242 and log in using:

If you'd rather run the source code in this repo directly via Node.js, see the step-by-step instructions to get up and running in the contributing guide.

Connect your SDK

Find your preferred SDK in our list of official SDKs and import it into your project. Follow the setup guides for your specific SDK.

If you use the docker compose file from the previous step, here's the configuration details you'll need to get going:

If you use a different setup, your configuration details will most likely also be different.

Check a feature flag

Checking the state of a feature flag in your code is easy! The syntax will vary depending on your language, but all you need is a simple function call to check whether a flag is available. Here's how it might look in Java:

if (unleash.isEnabled("AwesomeFeature")) {
  // do new, flashy thing
} else {
  // do old, boring stuff
}

Try Unleash in the cloud

Want to explore Unleash without setting it up locally? Here are two easy ways to see it in action.

Live demo

Open a running Unleash environment in your browser with no signup or setup required. This shared demo instance includes the core functionality so you can quickly get a feel for how Unleash works.

→ Launch the live demo

Launch the live demo

Free Enterprise trial

Get your own dedicated instance with a free 14-day cloud trial. This includes the full Unleash Enterprise feature set; ideal when evaluating Unleash for production use.

→ Start your free trial


Deploying to a production server

To self-host Unleash in a production environment, you need to deploy it to a persistent server.

We provide guides for deploying to services like Heroku and DigitalOcean:

Deploy to Heroku Deploy to DigitalOcean

For more advanced configurations options, check out our documentation on:


Community and help

We know that learning a new tool can be hard and time-consuming. We have a growing community that loves to help out. Please don't hesitate to reach out for help.

Join Unleash on Slack

💬 Join Unleash on Slack if you want ask open questions about Unleash, feature toggling or discuss these topics in general.

💻 Create a GitHub issue if you have found a bug or have ideas on how to improve Unleash.

📚 Visit the documentation for more in-depth descriptions, how-to guides, and more.

📖 Learn more about the principles of building and scaling feature flag solutions.


Contribute to Unleash

Unleash is the largest open-source feature flag solution on GitHub. Building Unleash is a collaborative effort, and we owe a lot of gratitude to many smart and talented individuals. Building it together with the community ensures that we build a product that solves real problems for real people. We'd love to have your help too: Please feel free to open issues or provide pull requests.

Check out the CONTRIBUTING.md file for contribution guidelines and the Unleash developer guide for tips on environment setup, running the tests, and running Unleash from source. Before a pull request can be merged, contributors must read and agree to the Unleash Contributor License Agreement.

Contributors

The Unleash contributors


Documentation

You can visit the Unleash documentation at https://docs.getunleash.io. As of 2 February 2026, the Unleash documentation source code lives in its own repository: Unleash/unleash-documentation.

Features our users love

Flexibility and adaptability

Security and performance

Looking for more features?

If you're looking for one of the following features, please take a look at our Pro and Enterprise plans:


Architecture

Read more in the system overview section of the Unleash documentation.


Unleash SDKs

To connect your application to Unleash you'll need to use a client SDK for your programming language.

Official backend SDKs:

Official frontend SDKs:

Community SDKs:

If none of the official SDKs fit your need, there's also a number of community-developed SDKs where you might find an implementation for your preferred language (such as Elixir, Dart, Clojure, and more).


Users of Unleash

Unleash is trusted by thousands of companies all over the world.

Proud Open-Source users: (send us a message if you want to add your logo here)

The Unleash logo encircled by logos for Finn.no, nav (the Norwegian Labour and Welfare Administration), Budgets, Otovo, and Amedia. The encircling logos are all connected to the Unleash logo.


Migration guides

Unleash has evolved significantly over the past few years, and we know how hard it can be to keep software up to date. If you're using the current major version, upgrading shouldn't be an issue. If you're on a previous major version, check out the Unleash migration guide!


Want to know more about Unleash?

Videos and podcasts

Articles and more

unleash (Unleash/unleash)

Searching Database…

13.9K ·GitHub
这是什么?Unleash 是一个开源的功能管理平台,团队可以借助它开启或关闭功能、逐步放量发布新功能,并进行 A/B 测试,而无需重新部署代码。
这是托管服务,还是需要我自己运行的?它是一个带管理界面的服务器,你可以通过 Docker 自行部署(也可以直接用 Node.js 运行),另外还有可嵌入你应用中的客户端和服务端 SDK;Unleash 还提供托管的企业版云服务选项(付费)。
我该怎么把它跑起来?先安装 git 和 Docker,在代码仓库中运行 docker compose 配置,然后打开 localhost:4242,使用 admin / unleash4all 登录;之后再使用官方 SDK 之一将你的应用连接进来。
连接我的应用需要用哪个 SDK?从 15 个官方客户端/服务端 SDK 中选一个(Go、Java、Node.js、PHP、Python、Ruby、Rust、.NET、Android、Flutter、iOS、JavaScript、React、Svelte、Vue),或从 15 个以上社区 SDK 中选一个;后端 SDK 需要 API 令牌,前端 SDK 需要客户端密钥。
哪些功能需要付费套餐才能使用?免费的自托管版本不包含基于角色的访问控制、SSO、SCIM、额外环境、多项目支持以及高级用户分群;这些功能需要 Pro 或企业版套餐。
它适用于任何技术栈吗,还是需要特定的编程语言?它与语言和框架无关:你可以通过 Docker 在任何平台上自行部署服务器,并且官方提供了 8 个后端生态和 7 个前端生态的 SDK。
我的终端用户数据会被发送到 Unleash 的服务器吗?不会。Unleash 从设计阶段就注重隐私保护,以符合 GDPR 和 Schrems II 合规要求,终端用户数据永远不会离开你自己的应用。
开源版 Unleash 和 Unleash 企业版有什么区别?开源版通过 Docker 提供完整的自托管功能开关,包含 2 个环境;企业版则额外提供 RBAC、SSO、SCIM 自动配置、变更请求、更多环境、项目支持,以及托管的免费试用。
什么是激活策略?它们是一些规则,用于决定某个功能开关在特定用户或用户分群中何时开启,让你无需重新部署即可进行金丝雀发布、灰度放量、紧急开关和 A/B 测试。
什么是 Unleash Edge?它是一个扩展层,部署在 Unleash 服务器前面,让你能够支持任意数量的前端客户端,而不会让主实例过载。
不安装任何东西,我能试用 Unleash 吗?可以,你可以直接在浏览器中打开在线演示实例,无需注册;也可以免费试用 14 天的企业版云服务,包含全部功能。
Creator
Unleash
Size
306.8 MB
Stars
13.9K
Age
12y
Commits · 90 Days