> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/getting-started/setting-up-your-proxidize-proxies.md).

# Setting Up Your Proxidize Proxies

How to find your proxy credentials and connect Proxidize proxies on desktop, on your phone, and in automation tools.

Once you have an active plan, connecting your proxies takes just a few minutes.

This guide shows you where to find your credentials and how to connect them on desktop, on your phone, or in automation tools.

## Connect your proxies

{% stepper %}
{% step %}

### Find your proxies and copy your credentials

All of your proxies live in your dashboard at [app.proxidize.com](https://app.proxidize.com).

Open the product you purchased to see its proxies.

Proxies are copied in one of two formats:

* `IP:Port:Username:Password`
* `Username:Password@IP:Port`

**On the Per Proxy plan:** next to each proxy you'll see a copy button for each protocol, **HTTP** and **SOCKS5**. Press the one you want, and the full proxy is copied to your clipboard in your chosen format. See [Your Per Proxy List](/mobile-per-proxy/your-per-proxy-list.md).

{% hint style="info" %}
On Per Proxy, credentials are generated automatically and don't change when your IP rotates, so you never need to update your tools after a rotation.
{% endhint %}

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2Fm4RmdGvIMfvNJ9OOVAif%2FcopyProxyButton.png?alt=media&#x26;token=4396d193-77cd-4da3-8bd2-8c2de0062c3d" alt=""><figcaption></figcaption></figure>

**On Per GB plans:** your proxies are listed under **Formatted Proxy List** on the **Access Point** tab. Pick your format and ports, then copy the list or download it. See [Per GB Access Points](/per-gb-proxies/per-gb-access-points.md#copy-a-proxy-list).

**Authentication options:**

* **User / Pass:** the default. Works in any proxy-compatible tool.
* **IP Whitelist:** connect from an allowlisted public IP without sending a username and password. Best for servers and automation. If your public IP changes, add the new one to your allowlist so your tools keep connecting.

When your tool does send a username and password, the request authenticates with those credentials, and an allowlisted IP does not replace them.

For the full options, see [Proxy Output and Authentication on Per Proxy](/mobile-per-proxy/proxy-output-and-authentication-on-per-proxy.md) and [Per GB Access Points](/per-gb-proxies/per-gb-access-points.md).
{% endstep %}

{% step %}

### Choose how to connect

The best connection method depends on your device.

{% hint style="info" %}
Proxy traffic reaches destination ports `80` and `443` only.
{% endhint %}

{% tabs %}
{% tab title="Desktop" %}
We recommend the [**Proxidize Proxy Extension**](/tools/proxidize-proxy-extension.md), a lightweight browser extension that lets you connect to a proxy in one click, switch between proxies, and test them, without changing your system settings.

It is best for quick setups and testing.

* [Proxidize Proxy Extension for Chrome](https://chromewebstore.google.com/detail/proxidize-proxy-extension/gccdbcipcjgfnjlegofdhflkifgkdmpb)
* [Proxidize Proxy Extension for Firefox](https://addons.mozilla.org/en-US/firefox/addon/proxidize-proxy-extension/)
  {% endtab %}

{% tab title="iPhone or iPad" %}
Add the proxy in your Wi-Fi network settings.

See [Setting Up Your Proxidize Proxies on iOS](/getting-started/setting-up-your-proxidize-proxies/setting-up-your-proxidize-proxies-on-ios.md).
{% endtab %}

{% tab title="Scripts and tools" %}
Proxidize proxies work with any proxy-compatible tool.

Use the format most tools expect:

```
http://USERNAME:PASSWORD@HOST:PORT
```

The exact input format varies by tool, so check that tool's own documentation.

For the host and ports, see [Limits and Specs](/reference/limits-and-specs.md).
{% endtab %}

{% tab title="Anti-detect browser" %}
If the extension doesn't fit your setup, for example because you need several separate browser profiles, you can use an anti-detect browser instead.

Add your Proxidize credentials to each profile's proxy settings.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### Test your connection

Before running a full workflow, confirm the proxy works.

You can:

* Use the **Proxidize Proxy Extension** to connect and view the egress IP, or
* Run a quick command-line check:

```bash
curl -x "http://USERNAME:PASSWORD@HOST:PORT" https://ipv4.icanhazip.com
```

If the returned IP is different from your local IP, you're connected.
{% endstep %}
{% endstepper %}

***

## Troubleshooting

If a proxy won't connect, work through these checks:

1. Re-check the username, password, protocol and port.
2. If you use **IP Whitelist**, check that your current public IP is on the allowlist.
3. Check that your target uses port `80` or `443`.
4. Rotate the proxy (Per Proxy), or change the session name or access point (Per GB), then test again with curl to see whether the issue is in the tool or the proxy.

[Proxy Analytics](/tools/proxy-analytics.md) shows the reason a request failed in its **ERROR TYPE** column.

***

## Quick FAQ

<details>

<summary>Can I use my proxies on a phone?</summary>

Yes.

On an iPhone or iPad, add the proxy in your Wi-Fi settings. See [Setting Up Your Proxidize Proxies on iOS](/getting-started/setting-up-your-proxidize-proxies/setting-up-your-proxidize-proxies-on-ios.md).

</details>

<details>

<summary>Do my credentials change when the IP changes?</summary>

On Per Proxy, no: rotation changes the IP only.

On Per GB, the session name is part of the username, so a new session name gives you a new username.

</details>

<details>

<summary>Do you offer a VPN endpoint, such as WireGuard?</summary>

No.

Proxidize proxies connect over HTTP and SOCKS5, and Mobile proxies can also carry UDP over SOCKS5.

</details>

***

## Related articles

* [Quick Start with Proxidize Proxies](/getting-started/quick-start-with-proxidize-proxies.md)
* [Setting Up Your Proxidize Proxies on iOS](/getting-started/setting-up-your-proxidize-proxies/setting-up-your-proxidize-proxies-on-ios.md)
* [Per GB Connection Details and Username Format](/per-gb-proxies/per-gb-connection-details-and-username-format.md)
* [Proxy Analytics](/tools/proxy-analytics.md)
* [Verification](/account-and-billing/verification.md)

***

## <mark style="color:$primary;">Need help?</mark>

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.proxidize.com/getting-started/setting-up-your-proxidize-proxies.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.