Setup guide

Install Rebel IPTV in a few minutes

Answer a couple of quick questions and we'll walk you through the exact setup for your host — Docker Compose or a Podman unit, one focused step at a time. The GitHub repo is always the canonical source for the current image and options.

Step 1 of 6Runtime

How do you run containers?

This decides whether you get a Docker Compose file or a Podman unit — and the exact paths for your host.

Quick start (Docker)

Save this as docker-compose.yml, then run docker compose up -d:

services:
  iptv:
    image: rebeliptv/iptv:latest
    container_name: iptv
    hostname: iptv
    ports:
      - "8080:8080"
    environment:
      TZ: "Etc/UTC"
    volumes:
      - iptv-data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    dns:
      - 8.8.8.8
      - 1.1.1.1
    stop_grace_period: 30s
    restart: unless-stopped

volumes:
  iptv-data:

Bring it up with docker compose up -d.
Open the dashboard at http://your-host:8080.
Point any IPTV player, or a Jellyfin / Plex tuner, at /playlist and /epg.

Stuck on a step?

The GitHub repo has the full reference and release notes — open an issue there and we'll help you out.

Open an issue Read the FAQ