Category filter

Configuration profile to set Global HTTP proxy for tvOS

This document describes how organizations can employ a configuration profile to set up a global HTTP proxy on tvOS devices.

Setting up a global HTTP proxy helps safeguard devices from external security threats. It guarantees that all network traffic between monitored Apple TVs and the internet is routed via a secure proxy server. Utilizing a custom configuration profile that can be remotely deployed to multiple enrolled tvOS devices using Hexnode’s Deploy Custom Configuration feature, IT administrators can ensure that the proxy configurations are applied to the Apple TVs in their organization.


The configuration profile is supported only on supervised devices running tvOS 10.2 or later.


The configuration profile provided below is adapted from a third-party open-source site.

Configuration profile to configure global HTTP proxy

The device management profile contains the following settings for the configuration of a global HTTP proxy for Apple TV:

  • ProxyCaptiveLoginAllowed: If set to true, the key enables the device to show the login page for captive networks without using the proxy server.
  • ProxyType: Set the key value to Manual for a manual proxy type, with the profile containing the proxy server address, including its port, and optionally a username and password. The key value should be set to Auto for an auto proxy type, where you can enter a PAC URL.

If ProxyType is set to Manual, specify the following settings:

  • ProxyServer: The network address of the proxy server.
  • ProxyServerPort: The port number of the proxy server.
  • ProxyUsername: The username used to authenticate to the proxy server.
  • ProxyPassword: The password used to authenticate to the proxy server.

If ProxyType is set to Auto, specify the following settings:

  • ProxyPACURL: The URL of the PAC file that defines the proxy settings.
  • ProxyPACFallbackAllowed: If set to true, it is possible to connect directly to the destination if the proxy autoconfiguration (PAC) file is unavailable.

  • To create and customize configuration profiles, you can use tools like Apple Configurator, Profile Manager or manually create them using text editors.
  • Use non-encrypted .mobileconfig, .xml, or plist files to deploy profiles across tvOS devices.
  • Ensure that you do not associate conflicting configurations with the devices.
  • Use wildcards to fetch key values from the portal.
  • It is recommended to manually validate the configuration profile execution on a system before executing the action in bulk.
  • Hexnode will not be responsible for any damage/loss to the system on the behavior of the configuration profile.

  • Configuration Profile Repository