> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/integrations/proxy-integrations/macos.md).

# macOS

**macOS** is the computer operating system (OS) for Apple desktops and laptops.

Check this guide to see how to configure the following Oxylabs **proxies** for macOS:

* [**Residential & Mobile Proxies**](#residential-and-mobile-proxies)
* [**Datacenter Proxies**](#datacenter-proxies)
* [**Dedicated Datacenter Proxies (Self-service)**](#dedicated-datacenter-proxies-self-service)
* [**ISP Proxies**](#isp-proxies)
* [**Dedicated ISP Proxies**](#dedicated-isp-proxies)

### **Step 1**

Click on the **Apple icon** in the top left corner and open **System Preferences**.

<figure><img src="/files/CINpcb8MerUW27xkyOVU" alt="MacOS System preferences"><figcaption></figcaption></figure>

### **Step 2**

After opening **System Preferences**, select the **Network** panel icon.

<figure><img src="/files/d4P7QPOG5TFFUvoOq7kM" alt="MacOS Network"><figcaption></figcaption></figure>

### **Step 3**

Choose the **Wi-Fi network** you want to configure and click **Advanced** in the bottom-right corner.

<figure><img src="/files/uLOWQRt5pByBaxy6Ga1n" alt="MacOS Advanced WiFi Settings"><figcaption></figcaption></figure>

### **Step 4**

Click on the **Proxies** tab and then select `Web Proxy (HTTP)`, `Secure Web Proxy (HTTPS)`, or `SOCKS Proxy`.

<figure><img src="/files/86FiVXKVRLytkFnV8ePT" alt="Web Proxy HTTP"><figcaption></figcaption></figure>

### **Step 5**

Under **Web Proxy Server**, input your chosen proxy details:

* [Residential & Mobile Proxies](#residential-and-mobile-proxies)
* [Datacenter Proxies](#datacenter-proxies)
* [Dedicated Datacenter Proxies (Self-service)](#dedicated-datacenter-proxies-self-service)
* [ISP Proxies](#isp-proxies)
* [Dedicated ISP Proxies](#dedicated-isp-proxies)

#### Residential & Mobile Proxies

**Proxy host:** `pr.oxylabs.io`

**Proxy port:** `7777`

**Username:** `customer-username`

**Password:** `password`

{% hint style="warning" %}
Don't forget to add the `customer-` part to your username.
{% endhint %}

<figure><img src="/files/WpE9iNLgM2y3zRJfcxc3" alt="MacOS Web Proxy Server"><figcaption></figcaption></figure>

{% hint style="info" %}
You can also use country-specific entries to acquire a desired country exit node with a sticky session. For example, to use a US exit node, enter `us-pr.oxylabs.io` next to **Host or IP Address** and `10001` next to **Port**. You can find a complete list of location-specific information in our [documentation](/products/proxies/residential-proxies/location-settings.md).
{% endhint %}

#### Datacenter Proxies

**Proxy host:** `dc.oxylabs.io`

**Proxy port:** `8000`

**Username:** `user-username`

**Password:** `password`

{% hint style="warning" %}
Don't forget to add the `user-` part to your username.
{% endhint %}

<figure><img src="/files/vc2OSCQc1fHJ5D04vDzL" alt="MacOS Web Proxy Server"><figcaption></figcaption></figure>

{% hint style="info" %}
The port `8000` will pick a random IP address. For other settings, such as proxy IP rotation, visit [this documentation page](/products/proxies/datacenter-proxies/ip-control.md).
{% endhint %}

#### Dedicated Datacenter Proxies (Self-service)

**Proxy host:** `ddc.oxylabs.io`

**Proxy port:** `8001`

**Username:** `user-username`

**Password:** `password`

{% hint style="warning" %}
Don't forget to add the `user-` part to your username.
{% endhint %}

<figure><img src="/files/NUNZbZfgbKMxHylpkXdH" alt="MacOS Web Proxy Server"><figcaption></figcaption></figure>

{% hint style="info" %}
You will need to choose the port assigned to an IP address from the purchased [**proxy list**](https://developers.oxylabs.io/proxies/dedicated-datacenter-proxies/self-service/proxy-list)**,** which you can find on Oxylabs' dashboard. The `8001` port will pick the first IP address from your list for all requests.
{% endhint %}

#### ISP Proxies

**Proxy host:** `isp.oxylabs.io`

**Proxy port:** `8001`

**Username:** `user-username`

**Password:** `password`

{% hint style="warning" %}
Don't forget to add the `user-` part to your username.
{% endhint %}

<figure><img src="/files/A9G0TqdQM9aQnplp4Qas" alt="MacOS Web Proxy Server"><figcaption></figcaption></figure>

{% hint style="info" %}
You will need to choose the port assigned to an IP address from the purchased [**proxy list**](/products/proxies/isp-proxies/proxy-list.md)**,** which you can find on Oxylabs' dashboard. The `8001` port will pick the first IP address from your list for all requests.
{% endhint %}

#### Dedicated ISP Proxies

**Proxy host:** `disp.oxylabs.io`

**Proxy port:** `8001`

**Username:** `user-USERNAME`

**Password:** `PASSWORD`

{% hint style="warning" %}
Don't forget to add the `user-` part to your username.
{% endhint %}

<figure><img src="/files/nTuIXNeLfC6mJZh4f3pA" alt="MacOS Web Proxy Server"><figcaption></figcaption></figure>

{% hint style="info" %}
You will need to choose the port assigned to an IP address from the purchased [proxy list](/products/proxies/dedicated-isp-proxies/self-service/proxy-list.md), which you can find on the Oxylabs dashboard. The `8001` port will pick the first IP address from your list for all requests. Use port `8000` for automatic [proxy IP rotation](/products/proxies/dedicated-isp-proxies/self-service/proxy-rotation.md).
{% endhint %}

### **Step 7**

Check the **Proxy server requires a password** box and type in your Oxylabs proxy user credentials:

**Username:** `Oxylabs proxy user username`

**Password:** `Oxylabs proxy user password`

{% hint style="info" %}
You can create and manage your proxy users in our [**dashboard**](https://dashboard.oxylabs.io/en/)**.**
{% endhint %}

<figure><img src="/files/lhIlPKuHGZX8HBc6Xngk" alt="MacOS Proxy server login"><figcaption></figcaption></figure>

{% hint style="warning" %}
Don't forget to add the `customer-` or `user-` prefix to your username according to your chosen proxy type.
{% endhint %}

After everything is set up, click **OK** to confirm and **Apply** to activate the settings.&#x20;

This is it, you’re using a proxy now.&#x20;

Find the original macOS integration blog post [here](https://oxylabs.io/resources/integrations/mac).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/integrations/proxy-integrations/macos.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.