Install a profile on Apple TV

tvOS has no Safari and no Files app, so a .mobileconfig can't be opened directly on the device. Instead, Apple TV downloads profiles from a URL through a hidden menu. The steps below work for any profile — including the proxy profiles ProxyBeam generates.

Host the profile at a URL

Apple TV can only fetch profiles from a link — there is no way to open a local file. Put the .mobileconfig on any server the device can reach. If it's a debugging-proxy profile, ProxyBeam generates it and hosts it on your Mac automatically — the link is copied to your clipboard.

Open the hidden profile menu

On the Apple TV, go to Settings → General → Privacy & Security. Highlight Share Apple TV Analytics — but don't click it. Press Play/Pause on the remote — a menu with Add Profile appears.

Enter the URL and install

Choose Add Profile, enter the link and confirm the installation.

Tip: typing the URL with the remote is tedious. If an iPhone or iPad is nearby, a keyboard notification appears on it when you start typing — tap it and paste the link.

Trust the certificate if the profile adds one

Go to Settings → General → About → Certificate Trust and enable trust for the installed certificate. Proxy profiles need this step — without it, HTTPS traffic can't be decrypted.

Manage or delete profiles

Installed profiles live in Settings → General → VPN & Device Management. Keep one proxy profile at a time and delete it when you're done.

If something goes wrong

The profile won't download. Check that the device can reach the URL: same Wi-Fi network, no typo, and the server hosting the file is running. No internet after installing a proxy profile. All traffic goes through the proxy now — the proxy app must be running on your Mac. Start it, or delete the profile.

Charles Proxy on Apple TV

On iOS you can set a proxy right in the Wi-Fi settings. tvOS has no such setting — on an unmanaged Apple TV the way to do it is a configuration profile that sets the proxy and adds the root certificate to trusted ones. ProxyBeam generates that profile for you.

You'll need

· A Mac with Charles Proxy installed and running · An Apple TV on the same Wi-Fi network as the Mac · An iPhone or iPad — optional, for easier URL entry

Save the Charles Proxy certificate

In Charles Proxy on your Mac, choose Help → SSL Proxying → Save Charles Root Certificate… and save the certificate in the .cer format.

Generate the profile in ProxyBeam

Open ProxyBeam and drag the saved .cer file into the window (or click Choose File…). The app starts a local server and shows a link like http://192.168.x.x:PORT/proxy.mobileconfig. Click the link — it's copied to your clipboard.

Install the profile on Apple TV

On the Apple TV, open Settings → General → Privacy & Security. Highlight Share Apple TV Analytics — but don't click it. Press Play/Pause on the remote — a profile menu opens. Enter the link from step 2 and press Play/Pause to confirm.

Tip: typing the URL with the remote is tedious. If an iPhone or iPad is nearby, a keyboard notification appears on it when you start typing — tap it and paste the copied link.

Trust the certificate

Go to Settings → General → About → Certificate Trust and enable trust for Charles Proxy CA.

Make sure Charles Proxy is running

Charles Proxy must be running on the Mac and listening for connections — the default port is 8888. The Mac and the Apple TV must be on the same Wi-Fi network.

Important

One profile at a time. Delete the old profile before installing a new one — conflicting profiles can break networking on the device. Delete the profile when you're done. While it's active, all Apple TV traffic goes through the proxy — with Charles Proxy closed, the device has no internet. Remove it in Settings → General → VPN & Device Management. Your Mac's IP can change. If traffic stops being captured, the IP most likely changed. ProxyBeam detects the new address automatically — generate the profile again and reinstall it.

Proxyman on Apple TV

You'll need

· A Mac with Proxyman installed and running · An Apple TV on the same Wi-Fi network as the Mac · An iPhone or iPad — optional, for easier URL entry

Save the Proxyman certificate

In Proxyman on your Mac, choose Certificate → Export → Root Certificate as .cer… and save the certificate in the .cer format.

Generate the profile in ProxyBeam

Install the profile on Apple TV

Tip: typing the URL with the remote is tedious. If an iPhone or iPad is nearby, a keyboard notification appears on it when you start typing — tap it and paste the copied link.

Trust the certificate

Go to Settings → General → About → Certificate Trust and enable trust for Proxyman CA.

Make sure Proxyman is running

Proxyman must be running on the Mac and listening for connections — the default port is 9090. The Mac and the Apple TV must be on the same Wi-Fi network.

Important

One profile at a time. Delete the old profile before installing a new one — conflicting profiles can break networking on the device. Delete the profile when you're done. While it's active, all Apple TV traffic goes through the proxy — with Proxyman closed, the device has no internet. Remove it in Settings → General → VPN & Device Management. Your Mac's IP can change. If traffic stops being captured, the IP most likely changed. ProxyBeam detects the new address automatically — generate the profile again and reinstall it.

More guides: How to install a configuration profile on Apple TV · How to capture Apple TV traffic with Charles Proxy