Configure

Configure Residential Proxies in the dashboard under Proxy configuration. Each targeting and connection option you pick is written into the generated endpoint. This guide shows how those selections map to the endpoint string.

Open Proxy configuration

1. Sign in to the Geonode dashboard.
2. Under Proxies, open Residential Proxies.
3. Select the Proxy configuration tab.

Use the controls on the right (gateway, country, state, city, ASN/ISP, OS, protocol, session type). The endpoint box updates as you change them.

Endpoints format

At the top of the configuration area, choose how endpoints are printed. In this example the format is:

hostname:port:username:password

You can also switch between DNS and IP:

Endpoints count controls how many endpoint lines are generated (set to 1 in the example below).

Example endpoint

With the selections in the screenshot, the dashboard generates an endpoint like this:

103.66.181.189:9000:YOUR_USERNAME-country-de-state-badenwurttemberg-city-aalen-asn-553-os-ios:YOUR_PASSWORD

Break down the string

Targeting is always applied by appending flags to the username, not by changing the password.

How each selection changes the endpoint

Set options from broad to specific. Country first, then state, then city. ASN/ISP options depend on the location you already chose.

Gateway

Gateway is the entry point you connect to (for example Singapore). It does not add a -country- (or similar) flag to the username. Country targeting controls the exit IP location; gateway controls where you enter the Geonode network.

Country targeting

1. Open Country targeting.
2. Select a country (for example Germany).

The username gains a two-letter country code:

State targeting

1. Keep a country selected.
2. Open State targeting.
3. Select a state (for example Baden-W�rttemberg).

Spaces and special characters are normalized in the flag (for example Baden-W�rttemberg ? badenwurttemberg).

City targeting

1. Keep country and state selected.
2. Open City targeting.
3. Select a city (for example Aalen).

ASN / ISP targeting

1. Set location first (country, and optionally state and city).
2. Open ASN/ISP targeting.
3. Select a network (for example 553 - Belwue-Koordination).

OS targeting

1. Open OS targeting.
2. Select an OS (for example iOS).

Protocol and session type

These control connection behavior and which port range you use. They do not always add username flags the same way geo options do, but they change the host:port the dashboard prints.

For rotating HTTP/HTTPS, the dashboard notes a port range such as 9000-9010. The example endpoint uses port 9000.

Sticky sessions use a different port range and can add session lifetime flags when configured. Choose Sticky under Session type when you need the same IP for a period of time.

Putting it together

With the example selections:

Resulting username flags (in order):

-country-de-state-badenwurttemberg-city-aalen-asn-553-os-ios

Leave a level on Any (or clear it) when you do not need that restriction. The matching flag is removed from the username and the endpoint updates immediately.

When your endpoint looks right, continue to Send Your First Request to use it in a live call.