WG Connect WG Connect
Provider guide · IVPN

IVPN on Apple TV — import your WireGuard config into WG Connect

IVPN covers the usual platforms, but there is no IVPN app on the tvOS App Store, which leaves the Apple TV connecting straight out to the internet while everything else in the house is tunnelled. IVPN runs standard WireGuard and generates configuration files for third-party clients. WG Connect is an independent tvOS client that imports one and connects.

Why a third-party client is needed

tvOS requires a dedicated app, and the Apple TV audience is small enough that most VPN providers do not build one. But the protocol is open. IVPN's WireGuard servers are ordinary WireGuard servers, and a .conf file is just a text description of a tunnel — client software is interchangeable.

The practical consequence: you do not need IVPN to ship an Apple TV app. You need a config file and a tvOS WireGuard client.

Getting a WireGuard config from IVPN

IVPN offers WireGuard configuration generation for third-party clients from the account area on their website. Sign in and look for the WireGuard / device configuration section, then follow IVPN's own current instructions — the exact page layout changes from time to time, and some options depend on your plan.

The general shape of it:

  1. Sign in to your IVPN account and open the WireGuard configuration section
  2. Add a new device key — this is the one the Apple TV will use
  3. Choose the location or specific server the configuration should point at
  4. Select any server-side options IVPN offers at generation time (DNS / filtering choices, for instance) — they are written into the file
  5. Download the .conf to your phone or computer

Always make a dedicated config for the Apple TV. Reusing a laptop's key means two devices competing for the same tunnel, and the connection will bounce between them. A separate key also means you can revoke the TV alone if the device is ever sold or replaced.

What is inside the file

An [Interface] section with the private key, the tunnel's internal address and a DNS server, and a [Peer] section with the server's public key plus an Endpoint host and port. AllowedIPs = 0.0.0.0/0, ::/0 sends all traffic through the tunnel — the normal setting for a privacy VPN. The private key is stored in the clear, so handle the file like a password.

Importing it into WG Connect

An Apple TV has no camera, so it cannot scan a QR code a provider shows on screen. WG Connect inverts that: the TV is the one displaying the code. Four ways in, all producing the same profile:

  1. Upload from phone (easiest). On the Apple TV: Add Profile → Upload from Phone. The TV shows a QR code, you scan it with the phone holding the .conf, and a small upload page opens. Pick the file and it transfers to the TV over your local Wi-Fi — it never leaves the network.
  2. Paste the config text. Open the file in a text editor, copy everything, paste it in.
  3. Import from a URL. WG Connect can fetch the config from an address you supply. Only use hosts you control, since the file contains a private key.
  4. Manual entry. Enter private key, address, DNS, peer public key, endpoint and allowed IPs by hand. Slow with a remote, but it never fails.

WG Connect detects the protocol from the file itself. An IVPN config is plain WireGuard and will be handled as such — no protocol dropdown to get wrong. The same importer also handles AmneziaWG configs if you have one from another source, and the profile screen shows which protocol was detected.

What to expect once connected

More than one location

A config points at one server. If you want a choice of countries, generate several from your IVPN account and import each as its own profile. WG Connect stores as many profiles as you like and switches between them from the home screen in two clicks.

Independent app

WG Connect is an independent WireGuard and AmneziaWG client for tvOS, built by HANSEN AI. It is not affiliated with, endorsed by, or sponsored by IVPN, and it is not an IVPN product. All trademarks are the property of their respective owners. WG Connect does not sell VPN service — you bring your own configuration.

Frequently asked questions

Is there an IVPN app for Apple TV?

IVPN does not publish a tvOS app. It does run standard WireGuard and lets you generate WireGuard configuration files from your account area, so any WireGuard client for tvOS can carry the tunnel. WG Connect is one such independent client.

Does an Apple TV config use up one of my IVPN device slots?

Each WireGuard configuration is tied to a key registered on your account, and IVPN plans allow a certain number of connected devices. The Apple TV counts as one of them. Generate a dedicated config for it rather than reusing another device's, and delete keys for devices you've retired.

Can the Apple TV scan a WireGuard QR code?

No — an Apple TV has no camera. WG Connect works the other way round: the TV shows a QR code, your phone scans it and opens a small upload page on the same Wi-Fi, and you send the .conf file to the TV over the local network. Pasting the config text, importing from a URL, and manual entry are also supported.

Do IVPN's multi-hop or AntiTracker features work with a plain config?

Anything IVPN implements on its servers is chosen when you generate the configuration — for example by selecting a particular entry point or DNS address — rather than toggled in the client afterwards. Anything implemented inside IVPN's own apps has no equivalent in a plain WireGuard config. Pick what you want at generation time.

Does WG Connect require a subscription?

No. WG Connect is a one-time purchase — no subscription, no account, no tracking. A free tier lets you check that your config connects before you buy, with each free session limited to 120 seconds. The purchase supports Family Sharing.

What are the requirements?

An Apple TV running tvOS 17 or later, plus a WireGuard or AmneziaWG configuration file. WG Connect detects which protocol a config uses automatically.

Download on the
App Store