Feature Flags
Review the notes below for details about recent changes to Harness Feature Flags (FF). For release notes for Harness Self-Managed Enterprise Edition, go to Self-Managed Enterprise Edition release notes. Additionally, Harness publishes security advisories for every release. Go to the Harness Trust Center to request access to the security advisories.
Last updated: October 22, 2026
October 2026
Relay Proxy
Version 1.0.25
Security:
Applied Ubuntu security patches to address vulnerabilities identified in USN-8737-2 and USN-8736-2.
Remediated vulnerabilities identified by Capital One Qualys, including updating golang.org/x/crypto to version 0.57.0 and applying operating system security patches. (FFM-13178)
Node.js SDK
Version 1.8.13
Bug fixes:
Refreshes configuration after an SSE reconnection to ensure the SDK uses up-to-date configuration. (FFM-13187)
September 2026
Relay Proxy
Version 1.0.24
Security:
Updated
golang.org/x/cryptoto version 0.56.0 to address security vulnerabilities. (FFM-13153)
Version 1.0.23
Security:
Remediated Go vulnerabilities in
x/cryptoand gRPC. (FFM-13153)
Version 1.0.22
Security:
Remediated an OpenSSL vulnerability by installing patched OpenSSL packages in the v1 runtime image. (FFM-13153)
August 2026
Relay Proxy
Version 2.0.32
Security:
Remediated a high-severity vulnerability in Echo and upgraded
klauspost/compressto address security vulnerabilities. (FFM-13075)Remediated container vulnerabilities. (FFM-13083)
Version 2.0.31
Security:
Remediated high and critical vulnerabilities in Relay Proxy dependencies and updated the Go builder. (FFM-12989)
Maintenance:
Updated
harness-commonto 1.8.1 for the ingress-nginx migration. (FFM-13035)Upgraded gRPC to version 1.82.1. (FFM-13038)
Version 1.0.21
Security:
Updated Go to version 1.25.13 to remediate CVE-2026-39821. (FFM-13103)
Version 1.0.20
Security:
Remediated an integer overflow vulnerability in
klauspost/compress. (FFM-13036)
iOS SDK
Version 1.3.6
Bug fixes:
Restored the ability to initialize the SDK after calling destroy. (FFM-13064)
July 2026
Relay Proxy
Version 2.0.29
Security:
Remediated high and critical vulnerabilities in Relay Proxy dependencies, including updates to Go and OpenTelemetry dependencies. (FFM-12989)
Maintenance:
Updated
harness-commonto 1.8.1 for the ingress-nginx migration. (FFM-13035)Upgraded gRPC to version 1.82.1. (FFM-13038)
Version 1.0.17
Security:
Updated Go to version 1.25.12 to remediate critical and high-severity vulnerabilities. (FFM-13053)
June 2026
Relay Proxy
Version 1.0.16
Security:
Remediated high and critical vulnerabilities in Relay Proxy v1 dependencies. (FFM-12989)
Updated the Go builder to version 1.25.11. (FFM-12989)
iOS SDK
Version 1.3.5
Bug fixes:
Added fail-fast behavior when evaluation retrieval fails during initialization. (FFM-12394)
Fixed excessive logging when a feature flag does not exist. (FFM-12586)
Maintenance:
Added URLs to the README. (FFM-12413)
May 2026
Relay Proxy
Version 2.0.27
Bug fixes:
Improved SSE connection reliability by refreshing authentication tokens in SSE event handlers and ensuring proxy health status is updated correctly after container restarts. (FFM-12924)
Added a priority retry queue for transient SSE fetch errors. (FFM-12924)
Closed SDK streams when a read-replica Redis connection is lost. (FFM-12947)
Version 1.0.15
Security:
Remediated Go standard library vulnerabilities. (FFM-12954)
April 2026
Relay Proxy
Version 2.0.26
Bug fixes:
Improved SSE connection reliability by refreshing authentication tokens in SSE event handlers and ensuring proxy health status is updated correctly after container restarts. (FFM-12924)
Added a priority retry queue for transient SSE fetch errors. (FFM-12924)
Version 2.0.25
Bug fixes:
Improved handling of transient SSE fetch errors with a priority retry queue. (FFM-12924)
Version 2.0.24
Bug fixes:
Improved SSE connection reliability by refreshing authentication tokens in SSE event handlers and ensuring proxy health status is updated correctly after container restarts. (FFM-12924)
Version 2.0.23
Bug fixes:
Fixed segment asset list generation to use the segment identifier instead of the segment name.
Version 1.0.14
Bug fixes:
Added retry logic for remote configuration fetches during startup. (FFM-12921)
Python SDK
Version 1.7.5
Fixed issues:
Added thread-safety to the
LRUCacheto resolve a race condition causing intermittentFLAG_NOT_FOUNDerrors. (FFM-12909)
January 2026
Relay Proxy
Version 2.0.20
Security:
Added
allowPrivilegeEscalation: falsesecurity context settings to the primary and replica deployments. (FFM-12794)
Maintenance:
Migrated the
ffProxyBuildAndPushpipeline to Git.Added Redis mTLS authentication support.
Version 1.0.10
Maintenance:
Migrated the
ffProxyBuildAndPushpipeline to Git.
Go SDK
Version 0.2.0
Maintenance:
Updated the OpenAPI code generator dependency to use the
github.com/deepmap/oapi-codegen/v2/cmd/oapi-codegenimport path, accommodating the newer organization name. (FFM-12672)Removed the
app.harness.ioconfiguration to prevent conflicts with the newer Harness0 configuration.Updated the SDK version to
0.2.0for the OpenAPI changes.
Version 0.1.27
Fixed issues:
Resolved a security vulnerability by updating core dependencies. (FFM-12790)
Node.js SDK
Version 1.8.12
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12658)
React Native SDK
Version 3.3.2
Maintenance:
Bumped React SDK dependency to 2.4.0. (FFM-12572)
React SDK
Version 2.4.0
Maintenance:
Bumped JavaScript SDK dependency to 1.32.0. (FFM-12571)
December 2025
Ruby SDK
Version 1.4.9
Maintenance:
Build and release pipeline testing for Harness Code. No code changes. (FFM-12573)
JavaScript SDK
Version 1.32.0
Bug fixes:
Extended retry delay to prevent excessive reconnect attempts within a short period. (FFM-12759)
Maintenance:
Build and release pipeline testing for Harness Code. (FFM-12567)
Updated dependencies in the React Redux and Preact examples to address security and maintenance updates.
Java SDK
Version 1.9.3
Maintenance:
Tested the Harness Code release flow. No code changes. (FFM-12566)
Updated the Gradle wrapper task version.
Android SDK
Version 2.2.7
Bug fixes:
Improved retry backoff behavior to prevent rapid reconnect loops under transient failure conditions. (FFM-12760)
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12557)
Version 2.2.6
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12557)
Updated the Android Gradle Plugin to 8.13.0 to include the latest upstream bug fixes and maintain compatibility with newer Android platform and Android Studio releases. (FFM-12658)
Python SDK
Version 1.7.3
Fixed issues:
Resolved security vulnerabilities
CVE-2025-8869andCVE-2024-47081by updating core dependencies. (FFM-12653)
.NET SDK
Version 1.7.6
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12559)
Version 1.7.5
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12559)
November 2025
JavaScript SDK
Version 1.31.3
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12567)
Ruby SDK
Version 1.4.8
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12573)
Version 1.4.7
Bug fixes:
Limited the number of targets that can be included in a single payload to prevent oversized batches and improve request reliability. (FFM-12713)
Maintenance:
Added documentation for the
initializedfunction.
Java SDK
Version 1.9.2
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12566)
Version 1.9.1
Bug fixes:
Fixed a
NullPointerExceptionin the retry interceptor that causedretrieveAllto fail with aCompletionException. (FFM-12715)
Erlang SDK
Version 3.0.3
Maintenance:
Updated
harness_ff_erlang_client_apidependency to resolve parsing issues with lowercaseContent-Typeheaders. (FFM-12712)
React Native SDK
Version 3.3.1
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12572)
React SDK
Version 2.3.1
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12571)
Relay Proxy
Version 2.0.18
Bug fixes:
Fixed an issue introduced in version 2.0.17 where the Relay Proxy could drop newly created flags or segments before writing them to the Redis cache. (FFM-12750)
Version 2.0.17
Maintenance:
Upgraded
golangto 1.25.2.Optimized how the Proxy retrieves Flag and Target Group config when changes are made.
Node.js SDK
Version 1.8.11
Maintenance:
Build and release pipeline has been migrated to Harness Code. (FFM-12568)
Version 1.8.10
New features and enhancements:
Validate and convert
Target.identifierto a string before sending to the metrics processor, improving data handling robustness. (FFM-12708)
Bug fixes:
Updated Axios dependency to resolve CVE-2025-58754. (FFM-12641)
Version bump and supporting updates related to Axios upgrade. (FFM-12641)
September 2025
Java SDK
Version 1.9.0
Bug fixes:
Fixed build failures when using JDK 24. (FFM-12512)
Resolved multiple security vulnerabilities (CVEs). (FFM-12578)
Fixed build compatibility issues to support Java 25. (FFM-12612)
Updated Gradle version to ensure compatibility with JDK 25 LTS builds. (FFM-12612)
Version bump and related maintenance updates for Java 25 compatibility. (FFM-12612)
Relay Proxy
Version 2.0.16
Maintenance:
Upgrade from golang 1.23.5 -> 1.23.12 to resolve vulnerability CVE-2025-22871. (FFM-12648)
Upgrade the Proxy's base image to use pushpin-1.41.0 to resolve vulnerabilities in the older base image. (FFM-12648)
Version 1.0.8
Maintenance:
Upgrade from golang 1.23.5 -> 1.23.12 to resolve vulnerability CVE-2025-22871. (FFM-12631)
Upgrade the Proxy's base image to use pushpin-1.41.0 to resolve vulnerabilities in the older base image. (FFM-12631)
Version 2.0.15
Bug fixes:
Fixes a issue where the Proxy could incorrectly detect a delta between cached Target Group/Flag configs and SaaS during a stream disconnect or on startup. This caused the Proxy to send unnecessary SSE event to SDKs, even when no changes occurred. (FFM-12608)
August 2025
JavaScript SDK
Version 1.31.2
Bug fixes:
Apply
client.registerAPIRequestMiddlewareto SDK streaming requests.
React Native Client SDK
Version 3.3.0
New features and enhancements:
Update the React SDK to v2.3.0.
Node.js SDK
Version 1.8.9
Bug fixes:
The SDK now retries on certain recoverable network errors.
Version 1.8.8
New features and enhancements:
Support for providing
tlsTrustedCa/httpsCatoStreamProcessor.
Fixed issues:
Internal version bump. (FFM-12520)
.NET SDK
Version 1.7.4
New features and enhancements:
Improved error logging: the SDK now catches
HttpRequestExceptionand logs detailed DNS resolution errors instead of a generic HTTP error message. (FFM-12553)
Relay Proxy
Version 2.0.14
New features and enhancements:
Added support for additional environment variables to enable advanced Redis configuration. These provide greater flexibility for fine-tuning your Redis setup with the Relay Proxy. (FFM-12528)
REDIS_MAX_RETRIES REDIS_MIN_RETRY_BACKOFF_MILLIS REDIS_MAX_RETRY_BACKOFF_MILLIS REDIS_DIAL_TIMEOUT_SECONDS REDIS_READ_TIMEOUT_SECONDS REDIS_WRITE_TIMEOUT_SECONDS REDIS_POOL_SIZE REDIS_POOL_SIZE_LITERAL REDIS_POOL_TIMEOUT_SECONDS REDIS_MIN_IDLE_CONNS REDIS_MAX_IDLE_CONNS REDIS_MAX_ACTIVE_CONNS REDIS_CON_MAX_IDLE_TIME_MINUTES REDIS_CON_MAX_LIFETIME_MINUTESFor a full list and description of the available configuration options, see the Feature Flags documentation.
Maintenance:
Upgrade the
go-redisclient library version from 9.5.5 to 9.11.0. (FFM-12528)Upgrade dependencies to resolve an OAuth2.0 vulnerability. (FFM-12517)
July 2025
Java SDK
Version 1.8.3
Bug fixes:
Avoid logging disconnect errors on shutdown. A previous change (v1.8.0) unintentionally increased log noise by logging reset/cancel errors when the SDK was already shutting down. This fix ensures inflight requests aborted during shutdown are no longer logged, reducing misleading endpoint logs. (FFM-12506)
New feature and enhancements:
Added stack traces in logs to improve diagnostics during SDK operation. (FFM-12506)
Improved polling log messages to make them more unique and easier to trace. (FFM-12506)
Version 1.8.2
New features and enhancements:
Adding experimental support for HTTP proxy configuration. The SDK now supports the following system properties for proxies:
http(s).proxyHost,http(s).proxyPort,http.proxyUser, andhttp.proxyPassword. These are passed directly to OkHttp. (FFM-12489)
Relay Proxy
Version 2.0.13
New features and enhancements:
Optimized SSE event handling for Primary Proxy restarts or disconnections from Harness SaaS. The Proxy now sends patch events only for resources that changed while it was disconnected, instead of patching all flags. This reduces unnecessary updates and improves efficiency. The change is backward compatible and includes an automatic data structure migration in Redis on startup. (FFM-12528)
Security and Maintenance:
Updated Redis data model to support more efficient resource tracking during disconnections. While upgrading from Proxy version 2.0.12 or earlier to 2.0.13 requires no manual action, reverting back to 2.0.12 after an upgrade requires setting a different
REDIS_DBindex to avoid data incompatibility. (FFM-12441)
Node.js SDK
Version 1.8.8
New features and enhancements:
Added support for providing
tlsTrustedCa/httpsCatoStreamProcessor.
Maintenance:
Bumped version to address technical debt. (FFM-12520)
Version 1.8.7
Bug fixes:
Fixed an issue where the Node.js SDK did not retry after initialization failure. (FFM-12484)
Fixed an uncaught exception occurring when fetching flags or segments fails on SSE events. (FFM-12499)
.NET SDK
Version 1.7.3
This minor release updates the build process to sign the NuGet package, improving package integrity and trust.
Bug fixes:
Documentation fixes. (FFM-12465)
New features and enhancements:
Signed NuGet package as part of the build process. (FFM-12415)
June 2025
Relay Proxy
Version 2.0.12
Security and maintenance:
Adds HOST & Remote IP to the request logging middleware. (FFM-12488)
Updates dependencies to resolve a vulnerability in the
github.com/golang-jwt/jwtpackage. (FFM-12432)
Version 1.0.7
Security and maintenance:
Removed indirect dependency on
github.com/golang-jwt/jwtversion 3.2.2 or later which was incompatible for improved stability. (FFM-12443)
Java SDK
Version 1.8.1
Maintenance:
Migrated artifact publishing from OSSRH to the Maven Central Repository. This release includes no functional changes or bug fixes. (FFM-12481)
Android Client SDK
Version 2.2.5
Maintenance:
Migrated artifact publishing from OSSRH to Maven Central Repository. This release includes no functional changes or bug fixes. (FFM-12482)
Node.js SDK
Version 1.8.6
Bug fixes:
Various streaming reliability improvements and fixes to enhance connection stability and reduce disconnections. (FFM-12477)
April 2025
iOS SDK
Version 1.3.4
Bug fixes:
Fixed a crash that could occur when re-initializing the SDK. Replacing the custom singleton with a thread-safe
static letpattern to prevent force-unwrapping a nil optional. Also synchronizedinitializeanddestroyto avoid memory corruption. (FFM-12377)
Version 1.3.3
Bug fixes:
Fixed an issue where the main thread could be blocked if disk writing took too long. The
saveToDiskmethod now usesDispatchQueue.asyncto ensure the main thread returns immediately. (FFM-12377)
JavaScript SDK
Version 1.31.0
New features and enhancements:
Added a new
enableAnalyticsoption to control whether metrics are sent from the SDK. See the Options interface for usage details. (FFM-12373)
Security and maintenance:
Bumped
esbuildto address a CVE. As a result, the minimum Node version required to build the SDK is now 18. This change only affects development environments and does not alter the minimum supported Node version for SDK users.
Node.js SDK
Version 1.8.5
Bug fixes and enhancements:
Added retries for timed out requests and authentication requests.
Introduced
axiosRetriesoption to control the number of retries (see documentation).Removed dumping of entire Axios objects on request failures to reduce log noise.
Fixed an issue where
waitForInitialization()could unblock prematurely before flags and groups were fully loaded, preventing brief returns of default variations. (FFM-12374)
March 2025
Relay Proxy
Version 2.0.10
Fixed Issues:
Resolved an issue where the REDIS_DB environment variable was not passed to the Redis client, causing the default DB to be used regardless of configuration
Updated third-party dependencies to address security vulnerabilities identified by scanners.
Version 2.0.9
New features and enhancements:
Added support for rotating auth secrets without downtime or requiring SDK restarts.
Previously, updating the AUTH_SECRET invalidated existing SDK tokens. Now, you can assign a new AUTH_SECRET and move the old one to LEGACY_SECRETS. The Proxy will accept tokens signed with both. Once all SDKs are using tokens signed with the new secret, you can remove the legacy value.
Node.js SDK
Version 1.8.4
Bug fixes:
Reduced log verbosity for stream disconnection and retries. Now logs an error once per disconnection period, a warning on the first retry, the 10th attempt, and every 50th attempt thereafter. All other retries are logged at the
debuglevel. Also downgraded some overly verboseinfologs in the Evaluator todebuglevel. (FFM-12353)
Go SDK
Version 0.1.26
Bug fixes:
Fixed pipeline issues. (FFM-167)
Addressed .NET vulnerability. (FFM-12309)
Updated x/net dependency to latest version. (FFM-12359)
Resolved vulnerabilities related to infrastructure-as-code. (IAC-3407)
Python SDK
Version 1.7.2
Bug fixes:
Fixed an issue where string values were not correctly cast to booleans when evaluating a boolean equals clause (e.g. checking if a target with
premium: Truebelongs to a group with the rulepremiums equals true). Added error handling for failed type casts to prevent runtime errors and log the issue instead. (FFM-12349)
February 2025
Relay Proxy
Version 2.0.8
Upgrades packages and dependencies to resolve CVEs
Updates to documentation
JavaScript SDK
Version 1.30.0
New features and enhancements:
Added a new optional prop
onFlagNotFound, which triggers a callback when a requested flag cannot be found and a default variation is served. The callback receives two arguments:flagNotFound: A typeDefaultVariationEventPayload containing the flag identifier and the default variation.loading: A boolean indicating whether the SDK was still initializing at the time of the request.
This feature helps developers monitor when default variations are returned due to issues like typos, misconfigurations, or early variation calls before SDK initialization. It listens to the ERROR_DEFAULT_VARIATION_RETURNED event introduced in JavaScript SDK v1.29.0. See the README for usage details. (FFM-12306)
Maintenance:
Updated README documentation for clarity and to reflect recent SDK enhancements.
React Native Client SDK
Version 3.2.0
New features and enhancements:
Updated React SDK to latest version. (FFM-12322)
Version 3.1.0
New features and enhancements:
Updated React SDK to latest version. (FFM-12315)
React Client SDK
Version 2.2.0
New features and enhancements:
Added support to automatically re-initialize the SDK when configuration options change. (FFM-12320)
Version 2.1.0
Maintenance:
Bumped JavaScript SDK version and updated README documentation. (FFM-12313)
January 2025
Ruby SDK
Version 1.4.6
Fixed Issues:
Thread safety issues have been resolved. Previously, the Ruby SDK was marked a singleton and did not ensure only one instance can be created. This caused some issues where multiples were created in a quick period of time. This fix helps protect you from it. (FFM-12281)
Added
initializedmethod. This checks if client is initialized and returnstrueif initialization is complete andfalseif it has not. (FFM-12277)
Python SDK
Version 1.7.1
Bug fixes:
Increased the default size of the LRU cache to improve caching behavior. (FFM-12288)
Previous releases
Last updated
Was this helpful?