# How do I set up Nameless Proxy residential proxies?

> Set up Nameless Proxy residential proxies: gw.namelessproxy.com, port 7777 HTTP or 7778 SOCKS5, targeting and session in the username.

- URL: https://namelessproxy.com/help/set-up-residential-proxies/
- Last updated: 2026-11-13
- Publisher: Nameless Proxy (https://namelessproxy.com)

**Quick answer — How do I set up Nameless Proxy residential proxies?**

Point your tool at gw.namelessproxy.com, port 7777 for HTTP(S) or 7778 for SOCKS5, with the username and password of your **Nameless Proxy** plan. Targeting goes in the username: country, city, US state and ZIP, ASN, and a sticky session of 1 to 30 minutes. The Proxy generator writes up to 1,000 lines.

**In brief**

- **Gateway**: gw.namelessproxy.com, port 7777 for HTTP and HTTPS, 7778 for SOCKS5; the credentials sit in Residential, your plan, Overview.
- **Targeting**: Country and city targeting on every plan; in the United States also state and ZIP code; ASN targeting at no extra cost. City availability varies.
- **Sessions**: rotating by default; sticky for up to 30 minutes (the IP can change earlier), set in minutes inside the username.
- **Generator**: 1 to 1,000 lines in 5 formats, from host:port:user:pass to a Python snippet, to copy or download as .txt.
- **Other logins**: sub-users with their own traffic limit, or an IP whitelist instead of a password.

## What goes into each field of your proxy tool?

Most browsers, scrapers and libraries ask for the same handful of fields. The plan's Overview tab shows them under Connection details, with the password hidden until you reveal it.

*Nameless Proxy residential connection fields, their value and where the client area shows them*

| Field | Value | Shown in |
| --- | --- | --- |
| Host | gw.namelessproxy.com | Overview tab, Connection details |
| HTTP(S) port | 7777 | Overview tab and every generated line |
| SOCKS5 port | 7778 | Overview tab and every generated line |
| Username | The plan's login, plus optional targeting segments | Overview tab; Username of the first line in the generator |
| Password | Created per plan; Create a new password replaces it | Overview tab, hidden until shown |
| Login without a password | Whitelisted public IP or range (IPv4 /24 to /32, IPv6 /48 to /128) | API & whitelist page |

## How do you build a proxy list in the generator?

The generator runs in your browser and only offers the targeting the gateway understands, so every line it writes is valid.

1. **Open the plan** — Click Residential in the menu, open your plan, then the Proxy generator tab.
2. **Choose the login** — Under Use the login of, keep the main login or pick a sub-user with its own password and limit.
3. **Set the location** — Pick a Country or leave Any country, then optionally a State or region, a City, a 5-digit ZIP code or an Internet provider (ISP).
4. **Choose rotating or sticky** — Under IP rotation, Rotating gives a pool IP per connection; Sticky keeps one IP for the Session duration you type, from 1 to 30 minutes, or one of the presets of 5, 10, 15 and 30.
5. **Pick protocol, format and count** — Select HTTP(S) or SOCKS5, one of the 5 formats, and a Number of lines from 1 to 1,000.
6. **Copy or download** — Your proxy list updates as you change settings; copy it, press Download .txt, or press New sessions for fresh session IDs and new IPs.
7. **Run the test** — Under Test it, run the command shown; the answer gives the IP address and location a website sees.

## How does the username carry country, city and session?

**Each targeting choice is a pair of words added to your login with dashes, and any pair you leave out simply disappears.** Nameless Proxy counted 7 optional segments in its username format: country, state, city, ZIP, ASN, session ID and session length. Values are lower case, and spaces or dashes inside a name become underscores: New York becomes new_york.

The full template, then the example the client area itself prints for a US login with every segment filled:

*Username format and a filled example*

```text
USERNAME-country-{cc}-state-{state}-city-{city}-zip-{zip}-asn-{asn}-session-{id}-ttl-{minutes}

USERNAME-country-us-state-ny-city-new_york-zip-10001-asn-7922-session-a1b2c3d4-ttl-30
```

Read from left to right, that example asks for a US exit in New York State, in New York City, ZIP 10001, on the network of ASN 7922, and holds the same IP for 30 minutes under the session ID a1b2c3d4. Drop the session and ttl pairs and the same login rotates. State and ZIP apply in the United States only, and city coverage differs by country: when a country has no cities to offer, the generator says so instead of producing a line that would fail. A two-letter country code alone, such as country-de, is often all a job needs.

## Rotating or sticky: which one fits your job?

**Use rotating mode for broad crawling and sticky sessions for anything that must look like one visitor, such as a login, a cart or a multi-page form.** Rotating mode: each new connection gets an IP from the pool, usually a different one; to get a new IP on every request, send one request per connection (turn off keep-alive).

A sticky session keeps one IP for the minutes set in ttl, up to 30. The client area is explicit that the IP can change earlier, for example when the device behind it goes offline, so a script should expect a rare change mid-session and simply log in again.

Practical settings from the generator's presets:

- **5 minutes** for short checks such as a search results page per city;
- **10 to 15 minutes** for browsing a few pages of one site;
- **30 minutes** for a checkout, an account dashboard or a long form.

The New sessions button issues new 8-character session IDs for every line at once, which is the quickest way to move a whole list to fresh IPs. A longer comparison of the two modes is in [rotating vs sticky proxies](https://namelessproxy.com/guides/rotating-vs-sticky-proxies/ "Should I use rotating or sticky proxies?").

## How do you test that the proxy works?

**Run the curl command from the Overview tab or the generator: if it prints a JSON answer with an IP, a city and a country, the proxy works.** The client area builds the command for you with your real login; the shape is the one below.

*Test commands over HTTP and SOCKS5*

```bash
curl -x "http://USERNAME:PASSWORD@gw.namelessproxy.com:7777" https://ipinfo.io/json

curl -x "socks5h://USERNAME-country-de:PASSWORD@gw.namelessproxy.com:7778" https://ipinfo.io/json
```

The socks5h scheme hands the host name to the proxy, so the DNS lookup happens at the exit and not on your machine, as the curl documentation explains; the generator uses it in its SOCKS5 commands for that reason. In Python, SOCKS5 needs one extra package, installed with pip install requests[socks], and the generator's Python requests format prints a ready proxies dictionary. Library-by-library examples are in the [Python proxies guide](https://namelessproxy.com/guides/python-proxies/ "How do I use proxies with Python requests, httpx, aiohttp and Scrapy?"), and the first request from scratch is in the [quick start](https://namelessproxy.com/guides/quick-start/ "How do I send my first request through Nameless Proxy?").

## When should you use sub-users or the IP whitelist?

**Create a sub-user when a tool, a teammate or a client needs its own login and cap; whitelist an IP when a server should connect with no password at all.** Username and password on every plan, or an IP allowlist (up to 10 IPs). Sub-users with their own credentials and traffic cap. API keys you can revoke at any time.

Sub-users live in the plan's Sub-users tab. Each one gets a name only you see, a password of 8 to 64 characters (or one generated for you), and an optional traffic limit in GB. They share the plan's traffic, a limit stops a sub-user once it is reached, and Disable cuts its login at once without deleting it. The Statistics tab can then show the use of each login separately, per day and per country.

The IP whitelist sits on the API & whitelist page. Requests from a listed public address connect without a username and password, and changes take effect within a minute; private and reserved ranges are refused. A plan that runs low warns you in its Overview tab, and Auto-renew can buy the same plan again from the balance when less than 5% of the traffic is left, or 24 hours before an expiry date. Residential traffic itself never expires.

## Frequently asked questions

### Which protocols do Nameless Proxy residential proxies support?

HTTP, HTTPS and SOCKS5. Nameless Proxy uses port 7777 for HTTP and HTTPS and port 7778 for SOCKS5, on the same host and with the same login.

### How long can a Nameless Proxy sticky session last?

Up to 30 minutes, set with the ttl segment of the username. The IP can change earlier if the device behind it goes offline, so Nameless Proxy recommends scripts that log in again when that happens.

### Can I target a city in every country with Nameless Proxy?

No. Country targeting works everywhere Nameless Proxy sells, but city availability varies; the generator says when a country has no city to offer. State and ZIP code apply in the United States.

### Does Nameless Proxy residential traffic expire?

No, prepaid residential traffic never expires, and the Overview tab shows the expiry as Never. Nameless Proxy keeps what you have not used on the plan for later jobs.

### How does Nameless Proxy count the traffic I use?

Usage counts all data sent and received through the proxy (upload and download, headers included). 1 GB = 1,000,000,000 bytes. Connection attempts that fail before reaching the target are not counted. The Statistics tab shows the totals per day, per login and per country, with a CSV export.

**Verdict**

- **Use the Proxy generator** for any list longer than one line: it writes the targeting into the username correctly, up to 1,000 lines in 5 formats.
- **Choose sticky sessions of 10 to 30 minutes** for logins and checkouts, and rotating mode with keep-alive off when every request should leave from a new IP.

## Sources

1. [SOCKS proxies with curl (socks5h and remote name resolution)](https://everything.curl.dev/usingcurl/proxies/socks.html) — Everything curl (read 2026-11-13)
2. [RFC 1928: SOCKS Protocol Version 5](https://datatracker.ietf.org/doc/html/rfc1928) — IETF (read 2026-11-13)

**Get residential traffic that never expires** From $0.53/GB on the 1 TB pack, or $1.88 for 1 GB to test a target first. [Buy 1 GB](https://namelessproxy.com/app/checkout/?plan=res-1&product=residential&lang=en&from=help-set-up-residential-proxies) · [Open my residential plans](https://namelessproxy.com/app/residential?from=help-set-up-residential-proxies&lang=en)

---

Nameless Proxy: Nameless Proxy is a privacy-first, no-KYC proxy provider: rotating residential and 4G/5G mobile proxies, account-number login, and payment in crypto (Bitcoin, USDT, USDC). Residential from $0.53/GB.
