---
title: "Connection reference: hosts, ports and username parameters"
description: Every ProxyEmpire gateway host and port, the proxy string formats, username parameters for targeting and sessions, open ports and tested examples.
url: "https://proxyempire.io/docs/connection-reference/"
updated: "2026-11-16"
category: Getting Started
---

# Connection reference: hosts, ports and username parameters

Every host, port and username parameter in one place. Each proxy type has its own username and password, shown on its page in your dashboard; `USERNAME` and `PASSWORD` stand for them below.

- [Gateways](#gateways)
- [String formats](#formats)
- [Username parameters](#parameters)
- [Sessions](#sessions)
- [Other proxy types](#other-types)
- [Ports](#ports)
- [Examples](#examples)

## Gateways

| Proxy type | Host and port | Protocols |
| --- | --- | --- |
| Rotating Residential | `v2.proxyempire.io:5000` | HTTP, HTTPS, SOCKS5, UDP |
| Rotating Mobile | `v2.proxyempire.io:5000` | HTTP, HTTPS, SOCKS5, UDP |
| Rotating Datacenter | `datacenter.proxyempire.io:9000` | HTTP, HTTPS, SOCKS5 |
| ISP Proxies (Static Residential) | `static.proxyempire.io:9000` | HTTP, HTTPS, SOCKS5 |
| Unlimited Residential | `unlimited.proxyempire.io:5000` | HTTP, HTTPS, SOCKS5 |
| Dedicated Mobile | `mobdedi.proxyempire.io:9000` | HTTP, HTTPS, SOCKS5 |

All proxies use username and password authentication, and there is no IP whitelisting. The login differs per proxy type: residential usernames start with `r_` and mobile usernames with `m_`, for example. HTTP and SOCKS5 share the same host, port and login on every type, so only the scheme changes: `http://`, `socks5://` (DNS on your machine) or `socks5h://` (DNS at the proxy). UDP details are in [connection protocols](https://proxyempire.io/docs/what-connection-protocols-do-you-support/).

## Proxy string formats

Different tools expect the same four values in a different order. The Proxy Manager's proxy list and the [API](https://panel.proxyempire.io/docs) can output all three:

```
USERNAME:PASSWORD@v2.proxyempire.io:5000
v2.proxyempire.io:5000:USERNAME:PASSWORD
http://USERNAME:PASSWORD@v2.proxyempire.io:5000
```

## Username parameters

On Rotating Residential and Rotating Mobile, targeting and session settings are added to the username. Add them in the order of this table and leave out the ones you don't need:

```
USERNAME-country-us-region-california-city-los+angeles-sid-a1b2c3d4
```

| Parameter | Sets | Example |
| --- | --- | --- |
| `-country-` | Country code | `-country-us` |
| `-region-` | State or region | `-region-california` |
| `-city-` | City, with `+` for spaces | `-city-los+angeles` |
| `-isp-` | ISP, or the carrier on mobile | `-isp-at&t+internet` |
| `-asn-` | Network number, digits only. It sets the country by itself | `-asn-7922` |
| `-zip-` | ZIP or postal code. It needs a country and matches that code or a nearby one | `-zip-90210` |
| `-os-` | OS fingerprint: `windows`, `macos`, `linux` or `android` | `-os-windows` |
| `-sid-` | Sticky session ID: 8 letters or digits | `-sid-a1b2c3d4` |
| `-ttl-` | Session timer in minutes, after `-sid-` | `-ttl-30m` |

The Connection Builder lists the regions, cities, ZIP codes, ISPs and ASNs that have IPs online and writes the username for you, so copying from there is the safest route. The API lists the same values. Very narrow targeting, such as one ISP in a small city, means fewer available IPs. All targeting is included at no extra charge.

## Sessions and rotation

| Mode | In the username | What happens |
| --- | --- | --- |
| Every request | No `-sid-` | Each new connection gets a different IP. |
| Same IP | `-sid-a1b2c3d4` | The session keeps its IP until you rotate it or the device behind it goes offline. There is no fixed time limit. |
| Custom TTL | `-sid-a1b2c3d4-ttl-30m` | The IP changes on a timer you set, up to 2 hours (`-ttl-120m`). This is the longest an IP is kept, not the shortest. |

Reuse a session ID to keep its IP, use a new ID to get a new IP, and give each parallel task its own ID. More in [How to use sticky sessions](https://proxyempire.io/docs/how-to-use-proxy-sticky-sessions/).

## Other proxy types

### Rotating Datacenter

The country code comes straight after the username. Leave it out, or write `any`, for no country. Session parameters work as above. Targeting is by country only; use `uk` for the United Kingdom.

```
# A new IP in the United States on each request
USERNAME-us:PASSWORD@datacenter.proxyempire.io:9000
# One sticky IP, changed after 10 minutes
USERNAME-us-sid-12345678-ttl-10m:PASSWORD@datacenter.proxyempire.io:9000
```

### ISP Proxies (Static Residential)

Each IP has one fixed string, shown on the ISP Proxies page in your dashboard. The username ends with the IP itself. The IP doesn't change, so the username takes no targeting or session parameters. Buying, renewing and Auto Renew are covered in the [ISP Proxies guide](https://proxyempire.io/docs/isp-proxies/).

```
user_203.0.113.7:PASSWORD@static.proxyempire.io:9000
```

### Unlimited Residential

Add `-country-` for a country and `-sid-` for a sticky session. Without a session ID, each request gets a new IP. Targeting is by country only. Plans, sessions and usage statistics are covered in the [Unlimited Residential guide](https://proxyempire.io/docs/unlimited-residential/).

```
USERNAME-country-us-sid-a1b2c3d4:PASSWORD@unlimited.proxyempire.io:5000
```

### Dedicated Mobile

Each device has its own username and password, shown in the device list on the Dedicated Mobile page. The username takes no parameters. To request a new IP, click **Get New IP** or open the device's **Change IP by link** address. The link works without a login, from a browser or a script, so keep it private. Ordering a device and changing its location are covered in the [Dedicated Mobile guide](https://proxyempire.io/docs/dedicated-mobile/).

```
USERNAME:PASSWORD@mobdedi.proxyempire.io:9000
```

## Open ports

| Traffic | Ports | Status |
| --- | --- | --- |
| TCP, all proxy types | 80 and 443 | Open by default |
| UDP, Rotating Residential and Rotating Mobile | 443 and 53 | Open by default |
| Other ports | – | On request, after KYC and a use-case review |
| Email | 25 and other email ports | Never opened |

Some websites are blocked on all proxy types. See [blocked websites and ports](https://proxyempire.io/docs/are-there-any-blocked-websites/).

## Examples

Put proxy strings in quotes in a shell, because ISP names can contain `&`.

```
# One sticky IP in Germany over SOCKS5
curl --proxy "socks5h://USERNAME-country-de-sid-a1b2c3d4:PASSWORD@v2.proxyempire.io:5000" https://ipinfo.io/json

# Windows fingerprint on Comcast's network (the ASN sets the country)
curl --proxy "http://USERNAME-asn-7922-os-windows:PASSWORD@v2.proxyempire.io:5000" https://ipinfo.io/json
```

```
# Playwright (Python) takes the parts separately
proxy = {"server": "http://v2.proxyempire.io:5000", "username": "USERNAME-country-us-sid-a1b2c3d4", "password": "PASSWORD"}
```

To build strings by code, use `POST /proxy-list` in the [API](https://panel.proxyempire.io/docs), or ask the [ProxyEmpire MCP server](https://proxyempire.io/mcp-server/) in Claude, ChatGPT or Cursor. Connection not working? See [Why is my proxy not working?](https://proxyempire.io/docs/why-is-my-proxy-not-working/)
