selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
iptv-proxy logo

Self-host iptv-proxy

v4.7.1

IPTV reverse proxy for M3U and Xtream Codes

ReleaseOpen SourceGPL-3.0
Updated8 hours ago
LanguageGo
Setup difficultyEasy
Stars
736
Ports
8080 (HTTP proxy server), 5004 (HDHomeRun tuner (optional))
Docker
pierro777/iptv-proxy
Install with Docker

What is iptv-proxy?

This tool sits between your IPTV provider and your players. You give it a playlist URL or Xtream Codes credentials, and it serves the same content from a local address using a username and password you define. Apps like TiviMate, IPTV Smarters, VLC, and Kodi connect to the proxy instead of the provider directly. Media servers such as Plex, Jellyfin, Emby, and Channels DVR can treat the live channels as a virtual HDHomeRun tuner with a matched electronic program guide. The software runs as a single Go binary or Docker image with no database. It supports multiple users with individual stream limits, regular-expression channel filtering, HLS proxying, cached failover when the provider goes down, and merging several provider accounts into one catalogue. All settings come from flags, environment variables, or a YAML file. A read-only status page shows current streams and system health.

Should you self-host iptv-proxy?

iptv-proxy scores 55/100 on selfhost.directory (how scoring works) and ranks #24 of 54 in Media Streaming. It has 736 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v4.7.1, came out on 5 October 2026.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is Invidious (81/100, 25 800 stars). It scores higher overall, so compare the two before you pick. See iptv-proxy vs Invidious side by side.

Features

  • Channel Filtering
  • Configuration via flags, env vars, or YAML
  • HDHomeRun tuner emulation
  • HLS stream proxying
  • Logo proxying
  • M3U/M3U8 playlist proxy
  • Multiple provider sources merging
  • Multiple users with connection limits
  • No Database Required
  • Provider failover with cached responses
  • Read-only status page
  • Reverse proxy / HTTPS support
  • Stream sharing
  • Xtream Codes API proxy
  • Xtream passthrough mode

iptv-proxy README

How to install iptv-proxy

Install iptv-proxy with Docker

Environment variables
M3U_URL, PROXY_HOSTNAME, PROXY_USER, PROXY_PASSWORD, GIN_MODE

docker run -d --name iptv-proxy -p 8080:8080
-e M3U_URL="http://provider.example:8080/playlist.m3u"
-e PROXY_HOSTNAME=192.168.1.10
-e PROXY_USER=family
-e PROXY_PASSWORD=choose-a-password
-e GIN_MODE=release
pierro777/iptv-proxy:latest

Run with M3U playlist URL

iptv-proxy releases & version history

More in Proxy

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…