Managing Proxies
The Proxies page provides tools for adding, testing, and monitoring all your proxy connections. It is organized into tabs for easy navigation.
Page Layout
The Proxies page shows three tabs:
- All — Combined view of all proxies (rotating and static)
- Rotating — Only rotating proxy providers
- Static — Only static proxies
At the top of the page, summary stats show:
- Total proxy count
- Healthy proxy count
- Expiring Soon count (static proxies expiring within 7 days)
If a system gateway is configured, its status card appears above the tabs.
Adding a Rotating Proxy Provider
Open the Add Dialog
Click Add Proxy on the Proxies page. In the type selection step, choose Rotating Proxy (marked as “Recommended”).
Configure the Provider
Fill in the connection details:
| Field | Required | Description |
|---|---|---|
| Provider Name | Yes | A label to identify this provider (e.g., “BrightData Residential”) |
| Type | Yes | HTTP, HTTPS, or SOCKS5 |
| Host | Yes | The proxy gateway address from your provider |
| Port | Yes | Port number (1–65535) |
| Username | Yes | Authentication username |
| Password | Yes | Authentication password |
| Session Format | Yes | Provider-specific session format string (check your provider’s documentation) |
| Max Session Duration | Yes | Maximum minutes a single session lasts (default: 1440 / 24 hours) |
| Sticky Duration | No | Minutes to keep the same IP before rotating (1–1440). Leave empty for full rotation on every request. |
| Supported Countries | No | Comma-separated list of country codes available from this provider |
| Active | — | Toggle, enabled by default |
Save
Click Add. The provider appears in your proxy list and is immediately available for assignment to profiles.
Adding a Static Proxy
Open the Add Dialog
Click Add Proxy, then choose Static Proxy in the type selection step.
Enter Proxy Details
| Field | Required | Description |
|---|---|---|
| Type | Yes | HTTP, HTTPS, or SOCKS5 |
| Host | Yes | The proxy IP address |
| Port | Yes | Port number (1–65535) |
| Username | No | Authentication username (if required) |
| Password | No | Authentication password (if required) |
| Country | No | 2-letter country code (e.g., “US”, “DE”) |
| City | No | City name for reference |
| Expires At | No | Expiration date if the proxy has a limited lifespan |
| Active | — | Toggle, enabled by default |
Save
Click Add. The proxy appears in your list.
Testing Proxies
You can test any proxy to verify it is working correctly. Click the Test button on a proxy’s row in the table. The test:
- Connects through the proxy
- Measures response time (latency)
- Resolves the external IP address
- Reports success or failure
Test results show:
- Success — Green checkmark with response time and the external IP the proxy resolves to
- Failure — Red alert with the error message explaining why the connection failed
Test results are cached for the current session. The “Last Check” column shows when the proxy was last tested.
Health Monitoring
Proxies are monitored for health with the following statuses:
| Status | Condition |
|---|---|
| Healthy | Active, zero failures, not expired |
| Warning | Active but has some recorded failures |
| Error | Inactive or has excessive failures |
| Expired | Static proxy past its expiration date |
The summary stats at the top of the page aggregate these statuses so you can see your proxy health at a glance.
Expiration Tracking
Static proxies with an Expires At date are tracked for upcoming expiration:
- Proxies expiring within 3 days are highlighted in amber
- Proxies that have already expired are highlighted in red
- The “Expiring Soon” stat counts proxies expiring within 7 days
Expired proxies stop working. Profiles assigned to expired proxies will fail to connect. Monitor the expiration stats and replace proxies before they expire.
Editing Proxies
Click the action menu on any proxy row to edit it. You can update all fields except the proxy type. For security, the password field is shown empty — enter a new password only if you want to change it.
Deleting Proxies
Select Delete from the action menu. Deletion is permanent and cannot be undone. Proxies that are currently assigned to profiles can still be deleted, but those profiles will lose their proxy assignment and connect without one.