Plex Said My Server Was Offline on Apple TV. Resetting the Cache Fixed It.

I run Plex on a Mac mini through Docker and OrbStack. The Apple TV could see the server in its list, but opening it gave me an offline message.

My iPhone could browse the same library and play video. I ended up using AirPlay from the phone to watch on the same TV that couldn’t open the server in Plex.

Apparently, “offline” depended on which device I asked.

I checked the server, Docker networking, and whether the Mini’s IP address had changed. The thing that finally fixed it was Reset Cache in the Apple TV Plex app’s settings.

The server was answering

The obvious place to start was the Mini. Plex responded on port 32400 at its home-network address. It was signed into the right account. Plex’s account API listed it as online, and its registered secure URL resolved and accepted an HTTPS request from the Mini.

The Mac’s firewall was off. OrbStack was configured to expose published ports to the local network. The server logs showed the iPhone streaming successfully, without authentication rejections in the requests I reviewed.

That didn’t prove the Apple TV could reach it. It did make “the server is down” a hard explanation to keep working with.

There were a couple of things worth cleaning up. The Docker configuration only published the main TCP port, so I added Plex’s local discovery ports and restarted the container. The server also had a Docker container ID for its name. I gave it a name I could recognize.

Both changes made the setup easier to live with. The Apple TV still said offline.

The IP address theory

The Mini uses DHCP. Plex also had a custom access URL pointing to the Mini’s IP. If the router gave it a new address, that URL could point to the wrong place. Reasonable theory.

I checked the current address against the saved URL. They matched. I checked again the next day. Still matched, still offline on the Apple TV.

A DHCP reservation makes sense for a home server, especially when something is configured to use its address directly. But I couldn’t point to an address change that explained this failure.

The iPhone kept working throughout. That was the clue I should have given more weight to.

The fix was in the app

Fully quitting and reopening Plex on the Apple TV hadn’t helped. Then I went into Plex’s own settings and chose Reset Cache.

The server opened. Playback worked.

That’s the whole fix I can confirm. Open the Plex app on the Apple TV, reset its cache from the app’s settings, then try the server again.

My best guess is that some connection state in the app had gone stale. I didn’t capture the Apple TV logs before clearing it, so I can’t tell you whether it was holding onto an old endpoint, a failed connection result, or something else. I can say that the server was answering before the reset, and the Apple TV started working after it.

What I’d try first next time

If the Apple TV says offline while another device can browse and stream from the same server:

  1. Confirm the other device is actually streaming, rather than just displaying cached artwork.
  2. Grab the Apple TV app’s logs while it’s failing. Plex has instructions for downloading them over the local network.
  3. Reset the cache in the Apple TV Plex settings and try again.

If that doesn’t work, the logs give me somewhere specific to look. If it does, I’ve saved myself another round of checking a server that’s already streaming to my phone.

I spent a lot of time verifying the Mini. The setting that fixed it was on the TV.