2021-05-04 16:08:21 +02:00
---
id: index
title: Introduction
2021-06-04 14:10:37 +02:00
slug: /sdks
2021-05-04 16:08:21 +02:00
---
2021-12-09 13:33:30 +01:00
In order to connect your application to Unleash you will need a client SDK (software developer kit) for your programming language and an [API token ](../user_guide/api-token ). The SDK will handle connecting to the Unleash server instance and retrieving feature toggles based on your configuration. All versions of Unleash (OSS, Pro, and Enterprise) use the same client SDKs.
2021-05-04 16:08:21 +02:00
2021-12-09 13:33:30 +01:00
Unleash provides official client SDKs for a number of programming language. Additionally, our community have developed and contributed SDKs for other languages. So if you can't find your favorite language in the list of official SDKs, check out the [list of clients written by our fantastic community ](#clients-written-by-awesome-enthusiasts ).
2021-05-04 16:08:21 +02:00
2021-12-09 13:33:30 +01:00
## Official SDKs
### Server-side SDKs:
Server-side clients run on your server and communicate directly with your Unleash instance. We provide these official clients:
2021-05-04 16:08:21 +02:00
2021-06-04 14:38:11 +02:00
- [Java SDK ](/sdks/java_sdk )
- [Node.js SDK ](/sdks/node_sdk )
- [Go SDK ](/sdks/go_sdk )
- [Ruby SDK ](/sdks/ruby_sdk )
- [Python SDK ](/sdks/python_sdk )
- [.Net SDK ](/sdks/dot_net_sdk )
2021-08-19 13:34:05 +02:00
- [PHP SDK ](/sdks/php_sdk )
2021-06-04 13:44:34 +02:00
2021-12-09 13:33:30 +01:00
### Front-end SDKs
For security and performance reasons, the front-end SDKs do not communicate directly with your Unleash instance. Instead, they go via the [Unleash Proxy ](unleash-proxy.md ).
2021-06-04 13:44:34 +02:00
2021-06-04 14:38:11 +02:00
- [Javascript SDK ](/sdks/proxy-javascript )
2021-06-04 14:48:15 +02:00
- [Android SDK ](/sdks/android_proxy_sdk )
2021-06-04 13:52:32 +02:00
- [iOS Proxy SDK ](/sdks/proxy-ios )
2021-08-26 20:14:52 +02:00
- [React Proxy SDK ](/sdks/proxy-react )
2021-05-04 16:08:21 +02:00
2021-12-09 13:14:20 +01:00
2021-12-09 13:33:30 +01:00
### Server-side SDK compatibility table
2021-12-09 13:14:20 +01:00
2021-12-09 13:33:30 +01:00
The below table shows what features the various server-side SDKs support. Note that certain features make sense only for some clients due to how the programming language works or due to how the client works.
2021-12-09 13:14:20 +01:00
**Legend**:
- ✅: Implemented
- ⭕: Not yet implemented, but we're looking into it
- ❌: Not implemented, not planned
- **N/A**: Not applicable to this SDK
2021-12-09 13:33:30 +01:00
:::note
2021-12-09 13:54:06 +01:00
If you see an item marked with a ❌ that you would find useful, feel free to reach out to us ([on Slack](https://join.slack.com/t/unleash-community/shared_invite/zt-8b6l1uut-LL67kLpIXm9bcN3~6RVaRQ), for instance) with your use case. It may not be something we can prioritize right now, but if you'd like to contribute it back to the community, we'd love to help you build it.
2021-12-09 13:33:30 +01:00
:::
2021-12-09 13:14:20 +01:00
2021-12-10 15:17:07 +01:00
| Capability | [Java ](/sdks/java_sdk ) | [Node.js ](/sdks/node_sdk ) | [Go ](/sdks/go_sdk ) | [Python ](/sdks/python_sdk ) | [Ruby ](/sdks/ruby_sdk ) | [.Net ](/sdks/dot_net_sdk ) | [PHP ](/sdks/php_sdk ) | [Unleash Proxy Server ](unleash-proxy.md ) |
|---------------------------------------------------------------------------------------------------|:----------------------:|:-------------------------:|:------------------:|:--------------------------:|:----------------------:|:-------------------------:|:--------------------:|:----------------------------------------:|
| **Category: Initialization** | | | | | | | | |
| Async initialization | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A |
| Can block until synchronized | ✅ | ✅ | ⭕ | ⭕ | ⭕ | ✅ | ⭕ | N/A |
| Default refresh interval | 10s | 15s | 15s | 15s | 15s | 30s | 30s | 5s |
| Default metrics interval | 60s | 60s | 60s | 60s | 30s | 60s | 30s | 30s |
| Context provider | ✅ | N/A | N/A | N/A | N/A | ✅ | ✅ | N/A |
| Global fallback function | ✅ | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ | N/A |
| Toggle Query: `namePrefix` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| Toggle Query: `tags` | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ |
| Toggle Query: `project_name` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A | ✅ |
| **Category: Custom Headers** | | | | | | | | |
| static | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | N/A |
| function | ✅ | ✅ | ⭕ | ✅ | ⭕ | ✅ | ⭕ | N/A |
| **Category: Built-in strategies** | | | | | | | | |
| [Standard ](../user_guide/activation_strategy#standard ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| [Gradual rollout ](../user_guide/activation_strategy#gradual-rollout ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
2021-12-16 21:03:25 +01:00
| [Gradual rollout: custom stickiness ](../user_guide/activation_strategy#customize-stickiness-beta ) | ✅ | ✅ | ⭕ | ✅ | ✅ | ✅ | ✅ | ✅ |
2021-12-10 15:17:07 +01:00
| [UserID ](../user_guide/activation_strategy#userids ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| [IP ](../user_guide/activation_strategy#ips ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| [IP ](../user_guide/activation_strategy#ips ): CIDR syntax | ✅ | ✅ | ✅ | ✅ | ⭕ | ⭕ | ⭕ | ✅ |
| [Hostname ](../user_guide/activation_strategy#hostnames ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: [Custom strategies](../advanced/custom_activation_strategy)** | | | | | | | | |
| Basic support | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: [Strategy constraints](../advanced/strategy_constraints)** | | | | | | | | |
| Basic support (`IN`, `NOT_IN` operators) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: [Unleash Context](../user_guide/unleash_context)** | | | | | | | | |
| Static fields (`environment`, `appName` ) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Defined fields | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom properties | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: [`isEnabled`](../client-specification#implementation-of-isenabled)** | | | | | | | | |
| Can take context | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Override fallback value | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Fallback function | ✅ | ✅ | ✅ | ✅ | ✅ | ⭕ | ⭕ | ✅ |
| **Category: [Variants](../advanced/toggle_variants)** | | | | | | | | |
| Basic support | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom fallback variant | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Custom weight | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
2021-12-23 21:31:49 +01:00
| [Custom stickiness (beta) ](../advanced/stickiness#custom-stickiness-beta ) | ✅ | ✅ | ⭕ | ✅ | ✅ | ✅ | ✅ | ✅ |
2021-12-10 15:17:07 +01:00
| **Category: Local backup** | | | | | | | | |
| File based backup | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: Usage metrics** | | | | | | | | |
| Can disable metrics | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Client registration | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Basic usage metrics (yes/no) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| **Category: Bootstrap (beta)** | | | | | | | | |
| Bootstrap from file | ✅ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ |
| Custom Bootstrap implementation | ✅ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ | ⭕ |
2021-12-09 13:14:20 +01:00
2021-12-09 13:33:30 +01:00
## Clients written by awesome enthusiasts {#clients-written-by-awesome-enthusiasts}
Here's some of the fantastic work our community has done to make Unleash work in even more contexts. If you still can't find your favorite language, let us know and we'd love to help you create the client for it!
2021-05-04 16:08:21 +02:00
- [cognitedata/unleash-client-rust ](https://github.com/cognitedata/unleash-client-rust ) (Rust)
- [silvercar/unleash-client-kotlin ](https://github.com/silvercar/unleash-client-kotlin ) (Kotlin)
- [uekoetter.dev/unleash-client-dart ](https://pub.dev/packages/unleash ) (Dart)
- [minds/unleash-client-php ](https://gitlab.com/minds/unleash-client-php ) (PHP)
- [Stogon/unleash-bundle ](https://git.stogon.io/Stogon/unleash-bundle/ ) (PHP - Symfony)
- [afontaine/unleash_ex ](https://gitlab.com/afontaine/unleash_ex ) (Elixir)
- [mikefrancis/laravel-unleash ](https://github.com/mikefrancis/laravel-unleash ) (Laravel - PHP)
- [AppsFlyer/clojure-unleash ](https://github.com/AppsFlyer/unleash-client-clojure ) (Clojure)
- [pmb0/nestjs-unleash ](https://github.com/pmb0/nestjs-unleash ) (NestJS - Node.js)
- _...your implementation for your favorite language._
