Get started

Quickstart

The easiest way to get started with Unleash is through a cloud-hosted free trial. This gives you a ready-to-use instance, so you can explore all Unleash features without any local setup.

In this guide, you’ll:

1

Sign up for a free, cloud-hosted Unleash Enterprise instance.

2

Create your first feature flag using the Unleash Admin UI.

3

Connect Unleash to your application by integrating an SDK into your codebase.

The Unleash Admin UI onboarding experience

If you prefer to manage your own infrastructure, see the self-hosted setup guide. To use the open-source version, see the instructions in the Unleash GitHub repository.

Sign up for an Unleash Enterprise Cloud trial

Start by signing up for a free 14-day trial of Unleash Enterprise Cloud. After you submit the form, you will receive a confirmation email. Follow the link in the email to set your password and log in to your Unleash instance.

Start free trial

Create your first feature flag

Once you’ve logged in, it’s time to create your first feature flag:

1

In the Unleash Admin UI, open the Default project.

2

Click New feature flag.

3

Enter a name, and click Create feature flag.

For more details on creating feature flags, see How to create a feature flag.

Connect your application to Unleash

Next, use one of the client or backend SDKs to connect Unleash with your application.

Explore our SDK examples directly in your browser with CodeSandbox. Check out the Unleash SDK Examples repository to try one now.

1

Create an API token

In the Unleash Admin UI, create a frontend API token in Admin settings > Access control > API access.

2

Get your Unleash API URL

Find the base URL of your Unleash Cloud instance.

For example, https://us.app.unleash-hosted.com/some-instance-id.

Your frontend API URL is this base URL with /api/frontend appended to it.

3

Initialize the SDK

In your application code, initialize the SDK using your API URL and token.

The following example shows how to use the JavaScript SDK to connect to your Unleash instance:

JavaScript SDK
1import { UnleashClient } from "unleash-proxy-client";
2
3const unleash = new UnleashClient({
4    url: "https://<YOUR_UNLEASH_INSTANCE>/api/frontend",
5    clientKey: "<YOUR_TOKEN>",
6    appName: "<YOUR_APP_NAME>",
7});
8
9unleash.on("synchronized", () => {
10    // Unleash is ready to serve updated feature flags.
11
12    // Check a feature flag
13    if (unleash.isEnabled("some-flag")) {
14        // do cool new things when the flag is enabled
15    }
16});

For examples that show how to connect to Unleash in other programming languages, see the Unleash SDK Examples repository.

Next steps

You have successfully connected Unleash to your application. To continue exploring, see the following resources: