Service endpoint configuration: Server-side SDKs

Server-side SDKs

This feature is available for the following server-side SDKs:

.NET (server-side)
Apex
C++ (server-side)
Erlang
Go
Haskell
Java
Lua
Node.js (server-side)
PHP
Python
Ruby
Rust

.NET (server-side)

Expand .NET (server-side) code sample

To configure an alternate service endpoint for the SDK, use the ServiceEndpoints builder method to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      var config = Configuration.Builder("YOUR_SDK_KEY")
          .ServiceEndpoints(Components.ServiceEndpoints()
            .RelayProxy("https://your-relay-proxy.com:8030"))
          .Build();

      var config = Configuration.Builder("YOUR_SDK_KEY")
          .ServiceEndpoints(Components.ServiceEndpoints()
            .Streaming("https://stream.launchdarkly.us")
            .Polling("https://sdk.launchdarkly.us")
            .Events("https://events.launchdarkly.us"))
          .Build();

      var config = Configuration.Builder("YOUR_SDK_KEY")
          .ServiceEndpoints(Components.ServiceEndpoints()
            .Streaming("https://stream.eu.launchdarkly.com")
            .Polling("https://sdk.eu.launchdarkly.com")
            .Events("https://events.eu.launchdarkly.com"))
          .Build();

Apex

Expand Apex code sample

First, set up the Apex bridge. If you are a federal customer, make sure you run the Apex bridge within your own FedRAMP-compliant environment. To learn more, read Use the LaunchDarkly Salesforce bridge.To configure an alternate service endpoint for the SDK, export the alternate URIs before you build the bridge:

      cd bridge && go build .

      # other required export statements...

      export LD_BASE_URI='https://sdk.launchdarkly.us'
      export LD_EVENTS_URL='https://events.launchdarkly.us'

      ./bridge

      cd bridge && go build .

      # other required export statements...

      export LD_BASE_URI='https://sdk.eu.launchdarkly.com'
      export LD_EVENTS_URL='https://events.eu.launchdarkly.com'

      ./bridge

C++ (server-side)

Expand C++ (server-side) code sample

To configure an alternate service endpoint for the SDK, use StreamingBaseUrl, PollingBaseUrl, and EventsBaseUrl to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      auto config_builder = server_side::ConfigBuilder("YOUR_SDK_KEY");
      config_builder.ServiceEndpoints()
          .RelayProxyBaseUrl("https://your-relay-proxy.com:8030");
      auto config = config_builder.Build();
      if (!config) {
          /* an error occurred, config is not valid */
      }

      LDServerConfigBuilder builder = LDServerConfigBuilder_New("YOUR_SDK_KEY");

      LDServerConfigBuilder_ServiceEndpoints_RelayProxyBaseURL(builder, "https://your-relay-proxy.com:8030")

      LDServerConfig config;
      LDStatus status = LDServerConfigBuilder_Build(builder, &config);
      if (!LDStatus_Ok(status)) {
          /* an error occurred, config is not valid */
      }

      struct LDConfig *config = LDConfigNew("YOUR_SDK_KEY");
      LDConfigSetStreamURI(config, "https://your-relay-proxy.com:8030");
      LDConfigSetBaseURI(config, "https://your-relay-proxy.com:8030");
      LDConfigSetEventsURI(config, "https://your-relay-proxy.com:8030");

      auto config_builder = server_side::ConfigBuilder("YOUR_SDK_KEY");
      config_builder.ServiceEndpoints()
          .StreamingBaseUrl("https://stream.launchdarkly.us")
          .PollingBaseUrl("https://sdk.launchdarkly.us")
          .EventsBaseUrl("https://events.launchdarkly.us")
      auto config = config_builder.Build();
      if (!config) {
          /* an error occurred, config is not valid */
      }

      LDServerConfigBuilder builder = LDServerConfigBuilder_New("YOUR_SDK_KEY");
      LDServerConfigBuilder_ServiceEndpoints_StreamingBaseURL(builder, "https://stream.launchdarkly.us")
      LDServerConfigBuilder_ServiceEndpoints_PollingBaseURL(builder, "https://sdk.launchdarkly.us")
      LDServerConfigBuilder_ServiceEndpoints_EventsBaseURL(builder, "https://events.launchdarkly.us")
      LDServerConfig config;

      LDStatus status = LDServerConfigBuilder_Build(builder, &config);

      if (!LDStatus_Ok(status)) {
          /* an error occurred, config is not valid */
      }

      struct LDConfig *config = LDConfigNew("YOUR_SDK_KEY");
      LDConfigSetStreamURI(config, "https://stream.launchdarkly.us");
      LDConfigSetBaseURI(config, "https://sdk.launchdarkly.us");
      LDConfigSetEventsURI(config, "https://events.launchdarkly.us");

      auto config_builder = server_side::ConfigBuilder("YOUR_SDK_KEY");
      config_builder.ServiceEndpoints()
          .StreamingBaseUrl("https://stream.eu.launchdarkly.com")
          .PollingBaseUrl("https://sdk.eu.launchdarkly.com")
          .EventsBaseUrl("https://events.eu.launchdarkly.com")
      auto config = config_builder.Build();
      if (!config) {
          /* an error occurred, config is not valid */
      }

      LDServerConfigBuilder builder = LDServerConfigBuilder_New("YOUR_SDK_KEY");
      LDServerConfigBuilder_ServiceEndpoints_StreamingBaseURL(builder, "https://stream.eu.launchdarkly.com")
      LDServerConfigBuilder_ServiceEndpoints_PollingBaseURL(builder, "https://sdk.eu.launchdarkly.com")
      LDServerConfigBuilder_ServiceEndpoints_EventsBaseURL(builder, "https://events.eu.launchdarkly.com")
      LDServerConfig config;

      LDStatus status = LDServerConfigBuilder_Build(builder, &config);

      if (!LDStatus_Ok(status)) {
          /* an error occurred, config is not valid */
      }

      struct LDConfig *config = LDConfigNew("YOUR_SDK_KEY");
      LDConfigSetStreamURI(config, "https://stream.eu.launchdarkly.com");
      LDConfigSetBaseURI(config, "https://sdk.eu.launchdarkly.com");
      LDConfigSetEventsURI(config, "https://events.eu.launchdarkly.com");

To learn more, read ServiceEndpoints() in ConfigBuilder.

Erlang

Expand Erlang code sample

To configure an alternate service endpoint for the SDK, use the stream_uri, base_uri, and events_uri properties to set the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      ldclient:start_instance("YOUR_SDK_KEY", #{
        stream_uri => "https://your-relay-proxy.com:8030",
        base_uri => "https://your-relay-proxy.com:8030",
        events_uri => "https://your-relay-proxy.com:8030"
      })

      ldclient:start_instance("YOUR_SDK_KEY", #{
        stream_uri => "https://stream.launchdarkly.us",
        base_uri => "https://sdk.launchdarkly.us",
        events_uri => "https://events.launchdarkly.us"
      })

      ldclient:start_instance("YOUR_SDK_KEY", #{
        stream_uri => "https://stream.eu.launchdarkly.com",
        base_uri => "https://sdk.eu.launchdarkly.com",
        events_uri => "https://events.eu.launchdarkly.com"
      })

Go

Expand Go code sample

To configure an alternate service endpoint for the SDK, use the Config.ServiceEndpoints property and interfaces.ServiceEndpoints() to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      // To use the Replay Proxy in proxy mode for both streaming and events:

      config := ld.Config{
          ServiceEndpoints: ldcomponents.RelayProxyEndpoints(
            "https://your-relay-proxy.com:8030"),
      }

      // Alternatively, to use the Relay Proxy in proxy mode for streaming,
      // but send events directly to LaunchDarkly, use:
      config := ld.Config{
          ServiceEndpoints: ldcomponents.RelayProxyEndpointsWithoutEvents(
              "https://your-relay-proxy.com:8030"),
      }

      config := ld.Config{
          ServiceEndpoints: interfaces.ServiceEndpoints{
            Streaming: "https://stream.launchdarkly.us",
            Polling: "https://sdk.launchdarkly.us",
            Events: "https://events.launchdarkly.us",
          },
      }

      config := ld.Config{
          ServiceEndpoints: interfaces.ServiceEndpoints{
            Streaming: "https://stream.eu.launchdarkly.com",
            Polling: "https://sdk.eu.launchdarkly.com",
            Events: "https://events.eu.launchdarkly.com",
          },
      }

If you are using LaunchDarkly Go SDK version 7.6 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, read EnableGzip and Configuring an SDK to use the Relay Proxy.

Haskell

Expand Haskell code sample

To configure an alternate service endpoint for the SDK, use configSetStreamURI, configSetBaseURI, and configSetEventsURI to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      {-# LANGUAGE OverloadedStrings #-}

      import LaunchDarkly.Server.Config

      import Data.Function ((&))

      config :: Config
      config = (makeConfig "YOUR_SDK_KEY")
          & configSetStreamURI "https://your-relay-proxy.com:8030"
          & configSetBaseURI "https://your-relay-proxy.com:8030"
          & configSetEventsURI "https://your-relay-proxy.com:8030"

      {-# LANGUAGE OverloadedStrings #-}

      import LaunchDarkly.Server.Config

      import Data.Function ((&))

      config :: Config
      config = (makeConfig "YOUR_SDK_KEY")
          & configSetStreamURI "https://stream.launchdarkly.us"
          & configSetBaseURI "https://sdk.launchdarkly.us"
          & configSetEventsURI "https://events.launchdarkly.us"

      {-# LANGUAGE OverloadedStrings #-}

      import LaunchDarkly.Server.Config

      import Data.Function ((&))

      config :: Config
      config = (makeConfig "YOUR_SDK_KEY")
          & configSetStreamURI "https://stream.eu.launchdarkly.com"
          & configSetBaseURI "https://sdk.eu.launchdarkly.com"
          & configSetEventsURI "https://events.eu.launchdarkly.com"

If you are using LaunchDarkly Haskell SDK version 4.4 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, read configSetCompressEvents and Configuring an SDK to use the Relay Proxy.

Java

Expand Java code sample

To configure an alternate service endpoint for the SDK, use the serviceEndpoints builder method to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      LDConfig config = new LDConfig.Builder()
        .serviceEndpoints(Components.serviceEndpoints()
          .relayProxy("https://your-relay-proxy.com:8030"))
        .build();

      LDConfig config = new LDConfig.Builder()
        .serviceEndpoints(Components.serviceEndpoints()
          .streaming("https://stream.launchdarkly.us")
          .polling("https://sdk.launchdarkly.us")
          .events("https://events.launchdarkly.us"))
        .build();

      LDConfig config = new LDConfig.Builder()
        .serviceEndpoints(Components.serviceEndpoints()
          .streaming("https://stream.eu.launchdarkly.com")
          .polling("https://sdk.eu.launchdarkly.com")
          .events("https://events.eu.launchdarkly.com"))
        .build();

Lua

Expand Lua code sample

To configure an alternate service endpoint for the SDK, use the serviceEndpoints property to specify the base URLs. Here are some examples for common base URLs that you might use instead of the defaults:

      local config = {
          serviceEndpoints = {
            streamingBaseURL = "https://your-relay-proxy.com:8030",
            pollingBaseURL = "https://your-relay-proxy.com:8030",
            eventsBaseURL = "https://your-relay-proxy.com:8030"
          }
      }

      local config = {
          key = "YOUR_SDK_KEY",
          streamURI = "https://your-relay-proxy.com:8030",
          baseURI = "https://your-relay-proxy.com:8030",
          eventsURI = "https://your-relay-proxy.com:8030",
      }

      local config = {
          serviceEndpoints = {
            streamingBaseURL = "https://stream.launchdarkly.us",
            pollingBaseURL = "https://sdk.launchdarkly.us",
            eventsBaseURL = "https://events.launchdarkly.us"
          }
      }

      local config = {
          key = "YOUR_SDK_KEY",
          streamURI = "https://stream.launchdarkly.us",
          baseURI = "https://sdk.launchdarkly.us",
          eventsURI = "https://events.launchdarkly.us",
      }

      local config = {
          serviceEndpoints = {
            streamingBaseURL = "https://stream.eu.launchdarkly.com",
            pollingBaseURL = "https://sdk.eu.launchdarkly.com",
            eventsBaseURL = "https://events.eu.launchdarkly.com"
          }
      }

      local config = {
          key = "YOUR_SDK_KEY",
          streamURI = "https://stream.eu.launchdarkly.com",
          baseURI = "https://sdk.eu.launchdarkly.com",
          eventsURI = "https://events.eu.launchdarkly.com",
      }

To learn more about the configuration options, read clientInit.

Node.js (server-side)

Expand Node.js (server-side) code sample

To configure an alternate service endpoint for the SDK, use the streamUri, baseUri, and eventsUri properties to specify the base URIs.Here are some examples for common base URIs that you might use instead of the defaults:

      import { LDOptions } from '@launchdarkly/node-server-sdk';

      const options: LDOptions = {
        streamUri: 'https://your-relay-proxy.com:8030',
        baseUri: 'https://your-relay-proxy.com:8030',
        eventsUri: 'https://your-relay-proxy.com:8030',
      };

      import { LDOptions } from '@launchdarkly/node-server-sdk';

      const options: LDOptions = {
        streamUri: 'https://stream.launchdarkly.us',
        baseUri: 'https://sdk.launchdarkly.us',
        eventsUri: 'https://events.launchdarkly.us',
      };

      import { LDOptions } from '@launchdarkly/node-server-sdk';

      const options: LDOptions = {
        streamUri: 'https://stream.eu.launchdarkly.com',
        baseUri: 'https://sdk.eu.launchdarkly.com',
        eventsUri: 'https://events.eu.launchdarkly.com',
      };

If you are using LaunchDarkly Node.js (server-side) SDK version 9.8 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, read enableEventCompression and Configuring an SDK to use the Relay Proxy.

PHP

Expand PHP code sample

To configure an alternate service endpoint for the SDK, use the base_uri and events_uri properties to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      $client = new LaunchDarkly\LDClient("YOUR_SDK_KEY",
          [ "base_uri" => "https://your-relay-proxy.com:8030",
            "events_uri" => "https://your-relay-proxy.com:8030" ]);

      $client = new LaunchDarkly\LDClient("YOUR_SDK_KEY",
          [ "base_uri" => "https://sdk.launchdarkly.us",
            "events_uri" => "https://events.launchdarkly.us" ]);

      $client = new LaunchDarkly\LDClient("YOUR_SDK_KEY",
          [ "base_uri" => "https://sdk.eu.launchdarkly.com",
            "events_uri" => "https://events.eu.launchdarkly.com" ]);

There is not a streaming service for the PHP SDK.

Python

Expand Python code sample

To configure an alternate service endpoint for the SDK, use the stream_uri, base_uri, and events_uri properties to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      config = Config(sdk_key='YOUR_SDK_KEY',
        stream_uri="https://your-relay-proxy.com:8030",
        base_uri="https://your-relay-proxy.com:8030",
        events_uri="https://your-relay-proxy.com:8030")

      config = Config(sdk_key='YOUR_SDK_KEY',
        stream_uri="https://stream.launchdarkly.us",
        base_uri="https://sdk.launchdarkly.us",
        events_uri="https://events.launchdarkly.us")

      config = Config(sdk_key='YOUR_SDK_KEY',
        stream_uri="https://stream.eu.launchdarkly.com",
        base_uri="https://sdk.eu.launchdarkly.com",
        events_uri="https://events.eu.launchdarkly.com")

If you are using LaunchDarkly Python SDK version 9.5 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, set enable_event_compression in the ldclient.config module and read Configuring an SDK to use the Relay Proxy.

Ruby

Expand Ruby code sample

      config = LaunchDarkly::Config.new(
        stream_uri: "https://your-relay-proxy.com:8030",
        base_uri: "https://your-relay-proxy.com:8030",
        events_uri: "https://your-relay-proxy.com:8030")

      config = LaunchDarkly::Config.new(
        stream_uri: "https://stream.launchdarkly.us",
        base_uri: "https://sdk.launchdarkly.us",
        events_uri: "https://events.launchdarkly.us")

      config = LaunchDarkly::Config.new(
        stream_uri: "https://stream.eu.launchdarkly.com",
        base_uri: "https://sdk.eu.launchdarkly.com",
        events_uri: "https://events.eu.launchdarkly.com")

If you are using LaunchDarkly Ruby SDK version 8.7 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, read compress_events and Configuring an SDK to use the Relay Proxy.

Rust

Expand Rust code sample

To configure an alternate service endpoint for the SDK, use the ConfigBuilder and ServiceEndpointsBuilder to specify the base URIs. Here are some examples for common base URIs that you might use instead of the defaults:

      let config = ConfigBuilder::new("YOUR_SDK_KEY")
          .service_endpoints(
              ServiceEndpointsBuilder::new().relay_proxy("https://your-relay-proxy.com:8030"),
          )
          .build();

      let config = ConfigBuilder::new("YOUR_SDK_KEY").service_endpoints(ServiceEndpointsBuilder::new()
        .streaming_base_url("https://stream.launchdarkly.us")
        .polling_base_url("https://sdk.launchdarkly.us")
        .events_base_url("https://events.launchdarkly.us"));

      let config = ConfigBuilder::new("YOUR_SDK_KEY").service_endpoints(ServiceEndpointsBuilder::new()
        .streaming_base_url("https://stream.eu.launchdarkly.com")
        .polling_base_url("https://sdk.eu.launchdarkly.com")
        .events_base_url("https://events.eu.launchdarkly.com"));

If you are using LaunchDarkly Rust SDK version 2.4 or greater and you choose to enable compression of event payloads, you must upgrade Relay Proxy to version 8.9 or greater. To learn more, read compress_events and Configuring an SDK to use the Relay Proxy.

​Server-side SDKs

​.NET (server-side)

​Apex

​C++ (server-side)

​Erlang

​Go

​Haskell

​Java

​Lua

​Node.js (server-side)

​PHP

​Python

​Ruby

​Rust

Server-side SDKs

.NET (server-side)

Apex

C++ (server-side)

Erlang

Go

Haskell

Java

Lua

Node.js (server-side)

PHP

Python

Ruby

Rust