FAQ
Questions, answered
What Rebel IPTV is, what it isn't, and how to get it running.
It's a self-hosted IPTV system. You run a small agent (a Docker container) that scrapes your channel sources into one clean M3U playlist and a matching XMLTV guide, lets you watch in the browser, and feeds any IPTV player or media-server tuner. If some sources are blocked in your region, an optional Rebel IPTV relay can pull them for you.
No. Rebel IPTV hosts and stores no streams — the relay is a pass-through that pulls each feed at request time and pipes it to you. The software also ships with no channels or sources; you point it at the sources you choose.
A machine that can run Docker (a NAS, mini-PC, homelab box or VPS), and at least one channel source to import. You host the container yourself — the agent handles the rest, building your playlist, guide and dashboard.
Yes. Alongside the curated lineup you can upload your own M3U file or paste M3U playlist URLs in the dashboard. The agent validates each feed and shows only the ones that are actually online, then merges them into the same playlist and guide as everything else.
Absolutely. The curated lineup is hundreds of channels, but you don't have to take all of them — enable, disable and reorder channels in the dashboard so you keep only the ones you care about, in the order you want. Live sports can be turned off or run on their own, too.
It's a live toggle in the dashboard (Settings → Source mode). In local mode — the default — the agent scrapes channels and live events directly on your own machine and serves everything itself. In relay mode ("Use Rebel IPTV playlist") it stops scraping and pulls ready-made channels, guide and events from the Rebel IPTV relay in pass-through mode, fetching each source from a region where it's reachable — so you keep watching even when those sources are blocked or geo-restricted in your country. Your lineup is the same either way.
Anything that reads a standard M3U + XMLTV: TiviMate, IPTV Smarters, VLC, Kodi, OTT Navigator and more. The built-in tuner also advertises a continuous TS pipe, so Jellyfin, Plex and Emby pick it up as Live TV with DVR.
Yes. Every render includes a full XMLTV guide with logos. Upcoming sports events are scheduled automatically as their own channels with matchup artwork. Filter to specific leagues, turn events off entirely with one env var, or run a sports-only lineup with no live TV.
From release 1.3.0 on, when a newer version is available an Update now button appears on the dashboard and in Settings → Server. One click pulls the latest image and restarts in place, keeping your data. It needs the Docker socket mounted in your compose and the :latest image tag — see the Setup guide. You can always update manually with `docker compose pull && docker compose up -d` instead.
Most channels and events are backed by more than one source, so if one goes offline the agent falls back to another. On top of that, live validation drops any feed that's actually dead before it reaches your playlist — and if a source is blocked or unreliable where you are, relay mode can pull it through the Rebel IPTV relay instead.
Rebel IPTV is infrastructure — a relay and curation layer that hosts no content and ships with no channels. You are responsible for ensuring you have the right to access whatever sources you configure, and for complying with the laws where you live. See our Acceptable Use page for details.
Still have a question?
Open an issue on GitHubOwn your live TV in an afternoon
Deploy the agent on your own box, point it at your sources, and watch on anything. You host it; you own it.