Unleash

Unleash

  • Documentation
  • API
  • Help

›User Documentation

User Documentation

  • Getting Started
  • Configuring Unleash
  • Client SDK
  • Feature Toggle Types
  • Feature Toggle Variants
  • Securing Unleash
  • Unleash Context
  • Activation Strategies
  • Client Specification
  • Migration Guide

Developer Guide

  • Developer guide
  • Database Schema
  • Database Backup
  • Import & Export

Guides

  • Google Auth Hook
  • Custom Activation Strategy
  • Feature Updates To slack

Getting Started

Requirements

You will need:

  • Node.js (version 12 or later)
  • PostgreSQL (version 10 or later)
  • Create an unleash user and database.

Start Unleash server

Whichever option you choose to start Unleash, you must specify a database URI (it can be set in the environment variable DATABASE_URL).

Once the server has started, you will see the message:

Unleash started on http://localhost:4242

Option one - from a terminal/bash shell

npm install unleash-server -g
unleash -d postgres://unleash_user:password@localhost:5432/unleash -p 4242

Option two - from Node.js

  1. Create a new folder/directory on your development computer.

  2. From a terminal/bash shell, install the dependencies:

    npm init
    npm install unleash-server --save
    
  3. Create a file called server.js, paste the following into it and save.

    const unleash = require('unleash-server');
    
    unleash
      .start({
        databaseUrl: 'postgres://unleash_user:password@localhost:5432/unleash',
        port: 4242,
      })
      .then(unleash => {
        console.log(
          `Unleash started on http://localhost:${unleash.app.get('port')}`,
        );
      });
    
  4. Run server.js:

    node server.js
    

Option three - use Docker

Launch the Unleash server Docker image.

docker run -d -e DATABASE_URL=postgres://user:pass@10.200.221.11:5432/unleash unleashorg/unleash-server

Test your server and create a sample API call

Once the Unleash server has started, go to localhost:4242 in your browser. If you see a list of example feature toggles, try modifying one of them with curl from a terminal/bash shell:

curl --location --request PUT 'http://localhost:4242/api/admin/features/Feature.A' --header 'Content-Type: application/json' --data-raw '{\
  "name": "Feature.A",\
  "description": "Dolor sit amet.",\
  "type": "release",\
  "enabled": false,\
  "stale": false,\
  "strategies": [\
    {\
      "name": "default",\
      "parameters": {}\
    }\
  ]\
}'\
Configuring Unleash →
  • Requirements
  • Start Unleash server
    • Option one - from a terminal/bash shell
    • Option two - from Node.js
    • Option three - use Docker
  • Test your server and create a sample API call
Unleash
Docs
Getting StartedSecuring UnleashAPI Reference
Community
User ShowcaseSlack communityUnleash-hosted.comTwitter
More
GitHubStar