Troubleshooting Stremio When Things Break
Stremio setups don't rot. If something stops working, it's almost never your whole stack failing at once. It's usually one specific thing, and the fix is almost always simpler than rebuilding.
Before you tear apart your setup, try these four checks, in order.
Check 1: Try a different stream
About 99% of "Stremio isn't working" is actually "that one stream isn't working". The addon returned a list of 5, 10, 20 results, your first pick didn't play, and your instinct is to blame everything.
Just try the next result down. Most addons return several streams per title, and one of them usually plays. If the second stream works, everything is fine. Your setup is working.
Check 2: Try a different addon
If every stream from one addon fails, maybe THAT addon is having a moment. If you followed our recommended addons, you've got at least two installed (AIOStreams plus one of MediaFusion or Comet). If your first addon fails completely, the second should still work.
If the second addon still works, the first one is having a bad day. Come back to it in an hour or two. Nothing else needs to change.
Check 3: Check status.elfhosted.com
If you're using our public instances, our status page shows the real-time state of every addon we host. If something is red on that page, it's us, and we're (hopefully) already fixing it. Make a cup of tea.
If you're using a private instance, your private instance has its own status page too. Check the health page linked from your ElfHosted dashboard.
Check 4: Is your provider account still OK?
If nothing plays anywhere and the three checks above turned up nothing, your provider account might be the problem. Log into your provider's dashboard and have a look:
- RealDebrid: is the subscription still active? Any ban or warning notices? (See sharing across devices for the multi-IP ban pattern and how to avoid it.)
- TorBox: subscription still active? Bandwidth allowance used up?
- Usenet provider (Eweka, UsenetServer, Newshosting, etc.): subscription paid? Monthly traffic remaining?
A lapsed or banned provider account is invisible to Stremio. All you see is "no streams found" or "playback failed", but the real issue is upstream at the provider.
If all four checks pass and you still can't play anything
The issue is probably further upstream still. Your Stremio app version, your internet connection, or something local to your device. But don't start reinstalling things. That's almost always how setups get worse, not better.
The best public-community starting points:
- Search r/StremioAddons on Reddit for what you're seeing.
- Search the specific addon's GitHub issues page (AIOStreams, MediaFusion, Comet, etc.).
Decent chance someone else hit the same thing recently and there's a fix pinned somewhere.
When DIY debugging isn't fun
Public-instance debugging is a scavenger hunt. Sometimes it's a 5-minute fix, sometimes it's 2 hours on a Sunday evening while your family asks why the TV isn't working.
If that scenario sounds familiar, the private side of our stack is built for this. Private subscribers get:
- The ElfHosted Discord, where our team and other customers are around when things break.
- A documented support process so you always know how to reach us and what to expect.
- 24/7 managed hosting. When something on our side goes wrong, we fix it. No "file a ticket, wait three days".
- Fast responses. Usually inside the hour, whatever time zone you're in.
If "my setup just works, especially when it breaks" matters to you, browse our private Stremio addon products.
A note on "fixing" things
Most Stremio setups don't need fixing. Stable stays stable if you don't fight it. If an addon has been working for you for weeks, don't start changing settings because someone on Reddit mentioned a cool new option. The cool new option is probably cool. It's also probably not worth breaking what you have.
When you should change config:
- An addon deprecates an option you rely on. Change it.
- A provider disappears (rare, but happens). Swap to another.
- A new feature you actually want is released. Configure carefully.
Otherwise, hands off. You're more likely to break something stable than improve it.
What's next
If you've worked through all this and Stremio is showing its limits (you want shared watch history across the family, proper kid profiles, a real library that survives restarts), read beyond Stremio for the next step: managed media servers.