<!--
{
  "availability" : [
    "macOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeviceManagement",
  "identifier" : "/documentation/DeviceManagement/ContentCaching",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Device Management"
    ],
    "preciseIdentifier" : "rmdm-declarations:ContentCaching"
  },
  "title" : "ContentCaching"
}
-->

# ContentCaching

The declaration to configure the Content Caching service.

```
object ContentCaching
```

## Discussion

Specify `com.apple.configuration.content-cache.settings` as the declaration type.

### Configuration availability

|||
|--------------------------------|--------------------------------------|
|Allowed in supervised enrollment|macOS                                 |
|Allowed in device enrollment    |N/A                                   |
|Allowed in user enrollment      |N/A                                   |
|Allowed in local enrollment     |macOS                                 |
|Allowed in system scope         |macOS                                 |
|Allowed in user scope           |N/A                                   |
|Apply                           |Only a single configuration is applied|

### Configuration examples

**Basic caching:**

This configuration enables content caching for both personal and shared content with automatic activation.

```json
{
    "Type": "com.apple.configuration.content-cache.settings",
    "Identifier": "EB13EE2B-5D63-4EBA-810F-5B81D07F5017",
    "ServerToken": "E180CA9A-F089-4FA3-BBDF-94CC159C4AE8",
    "Payload": {
        "AutoActivation": true,
        "AllowPersonalCaching": true,
        "AllowSharedCaching": true,
        "KeepAwake": true,
        "Port": 0
    }
}
```

**Advanced caching:**

This configuration sets up content caching with a parent cache server, a restricted listen range, and a fixed port.

```json
{
    "Type": "com.apple.configuration.content-cache.settings",
    "Identifier": "2A3B4C5D-6E7F-8A9B-0C1D-2E3F4A5B6C7D",
    "ServerToken": "F1E2D3C4-B5A6-7890-ABCD-EF1234567890",
    "Payload": {
        "AutoActivation": true,
        "AllowPersonalCaching": false,
        "AllowSharedCaching": true,
        "LocalSubnetsOnly": false,
        "ListenRangesOnly": true,
        "ListenRanges": [
            {
                "type": "IPv4",
                "first": "192.168.1.1",
                "last": "192.168.1.254"
            }
        ],
        "Parents": ["10.0.0.1"],
        "ParentSelectionPolicy": "first-available",
        "Port": 8080
    }
}
```

## Topics

### Objects

[`ContentCachingRangesItemObject`](/documentation/DeviceManagement/ContentCachingRangesItemObject)

A range of IP addresses to cache.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)