cert.fish Guide
Signing tools and accounts

Sideloading on Apple TV

What you need to install apps on an Apple TV, how to find its UDID, and which tools send apps to it from a phone or computer.

An Apple TV cannot sign or install an IPA itself. Another device signs the app and sends it to the TV over your home network.

What you need

You needWhy
A certificate registered to the Apple TV's own UDIDA certificate for your iPhone does not cover the TV. Each Apple TV needs its own.
An IPA built for tvOSiPhone IPAs do not run on Apple TV. Download pages list the tvOS file separately.
An iPhone, iPad, Mac or PC on the same networkIt signs the app and sends it to the TV.

cert.fish certificates are registered to one iPhone, so they do not work on an Apple TV. Providers that state Apple TV support include FlareStore, SwiftSign, AppleP12 and Signulous. Ask for an Apple TV certificate when ordering. Compare terms in certificate providers compared.

1. Find the Apple TV's UDID

The UDID is the TV's unique device ID. The provider registers the certificate to it.

  1. On the computer or phone, open a UDID site that supports Apple TV, such as udid.tv. It shows a short URL.
  2. On the Apple TV, open Settings > General > Privacy & Security.
  3. Highlight Share Apple TV Analytics and press Play/Pause on the remote.
  4. Choose Add Profile and type the URL exactly, including https://.
  5. Install the profile. The UDID appears on the site.
  6. Send the UDID to your provider. You get back a .p12 certificate file, its password, and a .mobileprovision profile.

2. Pick a tool to install with

ToolSends to the TV fromSigns with
FlareStore appiPhone, iPad, MacApple TV certificate
ATVLoadlyWindows, Mac, Linux (Docker)Apple TV certificate or Apple Account
SideloadlyMacApple Account
AppDBAny browserApple TV certificate, with an install quota
XcodeMacPaid developer account

With only an iPhone, use the FlareStore app. With a Windows PC, use ATVLoadly.

A free Apple Account also works with ATVLoadly and Sideloadly, under the same limits as on iPhone: apps expire after 7 days. ATVLoadly can refresh them automatically if it runs on an always-on computer. See free Apple Account.

3. Pair the Apple TV

Every tool except AppDB pairs the same way:

  1. Put the TV and the device running the tool on the same Wi-Fi network.
  2. On the Apple TV, open Settings > Remotes and Devices > Remote App and Devices. Stay on this screen.
  3. Start pairing in the tool. The TV appears within about 45 seconds.
  4. Enter the code shown on the TV into the tool.

If the TV does not appear, restart the tool and try again. On iPhone, the tool also needs Local Network permission. The FlareStore app then adds a VPN profile to reach the TV; you can turn it off after installing.

AppDB links the TV through the same Add Profile screen as step 1, using the profile URL it gives you.

4. Sign and install

  1. Import the Apple TV certificate into the tool: the .p12 file, its password, and the .mobileprovision file. With an Apple Account, sign in instead.
  2. Import the tvOS IPA.
  3. Sign it with the Apple TV certificate, not your iPhone one.
  4. Choose the paired Apple TV as the target and install.

If it fails

SymptomLikely cause
The TV never shows up to pairDifferent network, the TV left the Remote App and Devices screen, or Local Network permission is off
"Not supported on this device" errorThe IPA is an iPhone build, not tvOS
No valid provisioning profile, or the install is refusedThe certificate is not registered to this TV, or you signed with the iPhone certificate
Apps stop opening after 7 daysIt was signed with a free Apple Account and needs refreshing

For anything else, use the error index. A revoked certificate stops TV apps too; the certificate checker confirms it.

Sources