> ## Documentation Index
> Fetch the complete documentation index at: https://anyip.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get your first proxy connection running. Find your credentials in the Proxies page, choose residential or mobile, pick the hostname and port, set it up in your own app, and run an IP-check test.

If you have an active plan, complete the following to set up your first proxy. anyIP does not install anything on your device. You copy your credentials from the dashboard and paste them into the app or tool you want to use: Shadowrocket, FoxyProxy, Curl, Python, AdsPower, or Dolphin.

## Step 1: Get your credentials

Your proxy information is in your dashboard. There is no separate email containing a proxy list, and there is no node or proxy file to download.

1. Go to your [Dashboard > Proxies](https://anyip.io/account/).
2. Find the team member you want to use and click its **"Get Proxy Details"** button.
3. In the form, copy your **Username** (`user_XXXX`) and **Password**.

The credentials you create from this form appear directly under the form. As long as you do not change the team member password, the usernames you created previously keep working.

### Why is my username so long?

The value in the **Username** field is the full username, including any flags. A username such as `user_XXXX,type_mobile,country_US` is one string, not a username plus separate settings. Paste the whole line into the username field of your app. The password goes in the password field by itself.
The flags after `user_XXXX` control the proxy. You can add or remove them to change the location or network type. See the [Configuration Reference](/guides/configuration) for the full list.

### About team members

A team member is an additional set of proxy credentials. It is not a count of proxies or IPs. One team member can generate many proxy profiles and reach many IPs, so the number of team members does not cap how many proxies you can run.

The number of team members you can have on your account is set by your plan. For example, a plan with two team members gives you two sets of credentials. To get more sets of credentials, upgrade to a larger plan that includes more team members. Buying a top-up adds GB to your current plan; it does not add team members.

If your plan comes with two team members, you can use either one. There is no designated team member that you must select. Either one works. Team members are helpful when you want to give a co-worker proxy credentials of their own.

Team members can appear as **disabled**. A disabled team member cannot connect, and any proxy built from it will not pass the connection test, even when your account still has data left. To activate it:

1. Go to the **Proxies** page.
2. Find the team member marked as disabled.
3. Click **activate** on the right side.

### How many proxies can I create on my plan?

Plans are based on traffic (GB), not on a fixed number of proxies. You can create and use as many proxy profiles, sessions, and IPs as you need from a single team member. The limit is the amount of GB included in your subscription.
The team member count and the number of proxies you can generate are two separate things. A plan with two team members still lets you generate as many proxy configurations as you want from either team member.

### Generate many proxies at once

You can build as many proxy profiles as you need from one team member. To create them in bulk:

1. On the **Proxies** page, click **"Get Proxy Details"** to open the proxy configuration form.
2. Click **"Proxy List Generator"** (the green button).
3. Copy or paste as many profiles as you need. Select **mobile** if you want mobile IPs.

<Note>
  **Generated proxies still need an active plan**

  The Proxy List Generator produces valid-looking lines even when your account cannot connect. A line such as `portal.anyip.io:1080:user_XXXX,type_residential,country_US,session_...:PASSWORD` is still generated when your subscription has expired or you are out of data.

  If the generated proxies do not work, confirm that your subscription is active and that you have GB remaining. If your subscription has expired, renew it at [https://anyip.io/account/#/plans](https://anyip.io/account/#/plans). See [Billing & Data](/guides/billing-and-data) for the difference between a top-up and a renewal.
</Note>

## Step 2: Choose residential or mobile

anyIP provides both residential and mobile IPs. You can choose which one by attaching a flag to your username:

* `type_residential` for residential IPs.
* `type_mobile` for mobile IPs.

If you do not add a `type_` flag, the network assigns residential or mobile automatically (mixed). See [Network Types](/guides/network-types) for the trade-offs.

You can use the same credentials with different flags to get different locations or network types. Example:

```text theme={null}
user_XXXX,type_mobile,country_US
user_XXXX,type_mobile,country_IT
```

The first targets a United States IP and the second targets an Italian IP, using the same username and password. See the [Configuration Reference](/guides/configuration) for all flags.

## Step 3: Build the connection string

Most applications accept proxy configurations in this form:

```text theme={null}
http://user_YOURID:PASSWORD@portal.anyip.io:1080
```

If your application asks for separate fields instead of a single input, use these values:

| Setting           | Value                                                      |
| :---------------- | :--------------------------------------------------------- |
| **Protocol**      | `HTTP/HTTPS` or `SOCKS5` (all supported on the same port)  |
| **Host / Server** | `portal.anyip.io`                                          |
| **Port**          | `1080` or `443` (for standard username/password auth)      |
| **Username**      | `user_XXXX` (add flags to target location or network type) |
| **Password**      | Your proxy password                                        |

`portal.anyip.io` is the hostname you enter. There is no separate IP address to look up. When an app asks for an IP, enter `portal.anyip.io`. You can set a region-specific entry node if you want, listed in [Location Targeting](/guides/location-targeting#-performance-choosing-the-right-server), but `portal.anyip.io` routes you to the nearest one by default.

## Step 4: Set it up in your app

The configurations are carried out in the application you are using, not in the AnyIP dashboard. Before using your app, ensure to download or open it, and then enter your AnyIP credentials into the proxy configurations.

* On iPhone or iPad, install Shadowrocket or Potatso and enter the host, port, username, and password there. You do not need a separate AnyIP app.
* In FoxyProxy, create a proxy profile with host `portal.anyip.io`, port `1080`, proxy type SOCKS5 or HTTP, and your AnyIP username and password.
* In An anti-detect browser such as AdsPower or Dolphin, enter the same host, port, username, and password. The credential format is the same across these tools.

For screenshots and per-tool steps, see the [Integration Guides](/guides/integrations).

## Step 5: Test your connection

To confirm you are connected to anyIP, run this command in a terminal (Mac, Linux, Windows Subsystem for Linux):

```bash theme={null}
curl -x "http://user_XXXX:PASSWORD@portal.anyip.io:1080" http://ip-api.com/json
```

If it shows any IP that is different from your home internet, then you are connected. After this, you can use the application or website as you normally would. Once the proxy has been configured, no additional steps are required.

If your application contains a “Check Proxy” option and the test is unsuccessful, the IP address may not be visible on the first attempt. Please attempt the check again. If the test is still unsuccessful, confirm that the team member is activated and that your plan has available data.

<Tip>
  **Check system status**

  Before debugging a failed connection, check [status.anyip.io](https://status.anyip.io) to confirm the network is operational. For other connection errors, see [Troubleshooting](/guides/troubleshooting).
</Tip>

## Common first-use questions

### Where is my proxy list or node?

There is no separate proxy list email and no node file. Your credentials live in the dashboard under [Proxies > Get Proxy Details](https://anyip.io/account/). Generate or copy them there.

### Do I enter an IP address or a hostname?

Enter the hostname `portal.anyip.io`. Apps that ask for an IP accept this hostname. There is no fixed IP to copy from the dashboard.

### Which protocol should I pick, SOCKS5 or HTTP?

Both HTTP/HTTPS and SOCKS5 work on the same port (`1080`). Pick whichever your app supports. Anti-detect browsers usually work well with SOCKS5.

### How long does my plan last?

Plans are monthly subscriptions with a set amount of GB. You need both active subscription time and remaining GB to connect. To keep using the service, maintain an active subscription. Unused GB can roll over if you renew within 7 days of expiration. See [Billing & Data](/guides/billing-and-data) for the full rules.