---
updatedAt: 2026-05-18T19:36:22.000Z
agentTools:
  projectIndex: https://docs.logrocket.com/llms.txt
---

# Configure a Network Proxy (iOS)

Allow session collection on devices with proxy requirements

If a network proxy is required a configuration builder can be provided when initializing the SDK. Network proxies may be required if end users generate sessions on devices that have proxy requirements. To configure, set your proxy and its parameters as a variable and refer to that variable in your `proxyConfiguration` option when calling `initialize()`.

<Callout icon="🚧" theme="warn">
  These proxy configurations apply to proxies that accept [HTTP CONNECT](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods/CONNECT) requests to create a tunnel to the destination server. If you have set up a proxy following our guide to [proxy traffic through your own domain](https://docs.logrocket.com/docs/proxying-traffic-through-your-own-domain), you should instead provide your proxy URL as the `serverURL` during initialization.

```swift LogRocket 3.0
LogRocketSDK.initialize(configuration: Configuration(
  serverURL: "https://example.com/i",
))
```
```swift LogRocket pre-3.0
SDK.initialize(configuration: Configuration(
  serverURL: "https://example.com/i",
))
```
```objectivec
LROConfiguration *configuration = [[LROConfiguration alloc] initWithAppID:@"<APP_ID>"];
configuration.serverURL = @"https://example.com/i";
[LROSDK initializeWithConfiguration:configuration];
```

</Callout>

<br />

```swift Swift LogRocket 3.0
let proxyConfig = ProxyConfigurationBuilder()
proxyConfig.httpEnable(true);
proxyConfig.httpProxy("127.0.0.1");
proxyConfig.httpPort(8888);
proxyConfig.proxyUsername("username");
proxyConfig.proxyPassword("password");

LogRocketSDK.initialize(configuration: Configuration(
  appID: "<APP_SLUG>",
  proxyConfiguration: proxyConfig,
))
```
```swift Swift LogRocket pre-3.0
let proxyConfig = ProxyConfigurationBuilder()
proxyConfig.httpEnable(true);
proxyConfig.httpProxy("127.0.0.1");
proxyConfig.httpPort(8888);
proxyConfig.proxyUsername("username");
proxyConfig.proxyPassword("password");

SDK.initialize(configuration: Configuration(
  appID: "<APP_SLUG>",
  proxyConfiguration: proxyConfig,
))
```
```objectivec Objective-C
LROProxyConfigurationBuilder *proxyConfig = [[LROProxyConfigurationBuilder alloc] init];

[proxyConfig httpEnable:true]
[proxyConfig httpProxy:@"127.0.0.1"]
[proxyConfig httpPort:8888]
[proxyConfig proxyUsername:@"username"]
[proxyConfig proxyPassword:@"password"]

LROConfiguration *configuration = [[LROConfiguration alloc] initWithAppID:@"<APP_ID>"];
configuration.proxyConfiguration = proxyConfig;
[LROSDK initializeWithConfiguration:configuration];
```