---
title: "Configuring Cloudflare WARP Agent on macOS devices"
slug: "configuring-cloudflare-warp-agent-on-macos-devices"
tags: ["cloudflare", "cloudflare warp", "mdm parameters"]
updated: 2025-11-11T07:12:43Z
published: 2025-11-11T07:12:43Z
canonical: "help.scalefusion.com/configuring-cloudflare-warp-agent-on-macos-devices"
---

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

# Configuring Cloudflare WARP Agent on macOS devices

## Introduction

Cloudflare is a global cloud-based platform that provides security, performance, and reliability services for websites, applications, and networks. It acts as a reverse proxy between your users and your servers, helping to protect and accelerate your internet traffic.

The following article will help you deploy the WARP Client application on your managed macOS devices.

## Step 1: Publishing the Custom Payload

The following Payload is designed to enforce specific security and system settings related to Cloudflare WARP Client on managed macOS devices.

1. Copy the contents directly from below and add it to Custom Settings in the Device Profile, or click [here](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/Cloudflare_Mac.mobileconfig) to download the file and import it into the Device Profile.

```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>PayloadDisplayName</key>
        <string>Cloudflare WARP</string>
        <key>PayloadIdentifier</key>
        <string>cloudflare_warp</string>
        <key>PayloadOrganization</key>
        <string>Cloudflare, Ltd.</string>
        <key>PayloadRemovalDisallowed</key>
        <false/>
        <key>PayloadType</key>
        <string>Configuration</string>
        <key>PayloadScope</key>
        <string>System</string>
        <key>PayloadUUID</key>
        <string>YOUR_PAYLOAD_UUID_HERE</string>
        <key>PayloadVersion</key>
        <integer>1</integer>
        <key>PayloadContent</key>
        <array>
            <dict>
                <key>organization</key>
                <string>YOUR_TEAM_NAME_HERE</string>
                <key>auto_connect</key>
                <integer>120</integer>
                <key>onboarding</key>
                <false/>
                <key>PayloadDisplayName</key>
                <string>Warp Configuration</string>
                <key>PayloadIdentifier</key>
                <string>com.cloudflare.warp.YOUR_PAYLOAD_UUID_HERE</string>
                <key>PayloadOrganization</key>
                <string>Cloudflare Ltd.</string>
                <key>PayloadType</key>
                <string>com.cloudflare.warp</string>
                <key>PayloadUUID</key>
                <string>YOUR_PAYLOAD_UUID_HERE</string>
                <key>PayloadVersion</key>
                <integer>1</integer>
            </dict>
        </array>
    </dict>
</plist>
```
  1. In the payload, enter the **PayloadUUID** wherever (YOUR_PAYLOAD_UUID_HERE) is used. You can find out the PayloadUUID by running the command ***uuidgen****,* which will generate a value for PayloadUUID.
  2. Update your organization's string (YOUR_TEAM_NAME_HERE) with your [team name](https://developers.cloudflare.com/cloudflare-one/faq/getting-started-faq/#what-is-a-team-domainteam-name).
  3. In addition, you can modify the file with your desired [deployment parameters](https://developers.cloudflare.com/cloudflare-one/team-and-resources/devices/warp/deployment/mdm-deployment/parameters/).
2. Follow [our guide](/docs/custom-payload-for-macos) on how to add the Custom Payload in the Device Profile & deploy it to devices.
3. On the device, you should see the following custom payload in the Profiles section in System Preferences.

![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-M7MLURQL.png)

> [!CAUTION]
> Note:
> 
> 1. The Payload and its contents are sourced from various albeit authenticated Apple Developer communities and forums, and other sources.
> 2. Please validate them on a test machine before deploying them on all your managed devices.
> 3. Scalefusion has tested these Payloads, however, Scalefusion will not be responsible for any loss of data or system malfunction that may arise due to the incorrect usage of these payloads.

## Step 2: Installing the software using the PKG

1. Download the WARP Client pkg file from the following [Link](https://developers.cloudflare.com/cloudflare-one/team-and-resources/devices/warp/download-warp/#macos).
2. Once you have WARP client PKG, upload the PKG to the Enterprise store.

![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-AA85RXCX.png)
3. Follow [our guide](/docs/installing-enterprise-apps-pkg-files-to-macos-devices) to upload & publish the PKG using the Scalefusion Dashboard.
4. By completing this step, you deliver the WARP client to targeted macOS devices.

![](https://cdn.document360.io/175c0eac-012f-4410-bdc5-ac60794f82d8/Images/Documentation/image-29GT6RDC.png)