Quickstart

Get Dispatcharr up and running in minutes with Docker and configure your first IPTV streams

Get Dispatcharr running and streaming your first IPTV channels in under 5 minutes.

Prerequisites

• Docker installed on your system
• An M3U playlist URL or Xtream Codes credentials from your IPTV provider
• Port 9191 available (default web interface port)

Quick Start

1. Start Dispatcharr with Docker

   Pull and run the latest Dispatcharr image:

   docker pull ghcr.io/dispatcharr/dispatcharr:latest
   docker run -d \
     -p 9191:9191 \
     --name dispatcharr \
     -v dispatcharr_data:/data \
     ghcr.io/dispatcharr/dispatcharr:latest
   

   Dispatcharr will be available at http://localhost:9191 once the container starts.

2. Access the web interface

   Open your browser and navigate to:

   http://localhost:9191
   

   You’ll see the Dispatcharr login screen. The default credentials are created on first startup.

3. Add your first M3U source

   1. Log in to Dispatcharr
   2. Navigate to Settings → M3U Accounts
   3. Click Add M3U Account
   4. Enter your M3U playlist URL or Xtream Codes credentials:

   M3U Playlist

   Name: My IPTV Provider
   Type: M3U
   URL: http://example.com/playlist.m3u8
   

   Xtream Codes

   Name: My IPTV Provider
   Type: Xtream Codes
   Server URL: http://example.com:8080
   Username: your_username
   Password: your_password
   

   5. Click Save and wait for Dispatcharr to fetch your channels
4. View and configure channels

   1. Navigate to Channels in the sidebar
   2. Your imported channels will appear in the list
   3. Click on any channel to:
      • Assign channel numbers
      • Set channel groups
      • Configure EPG matching
      • Add channel logos
5. Start streaming

   Once channels are configured, you can stream them using:

   M3U Playlist

   Get your playlist URL:

   http://localhost:9191/output/m3u/
   

   Add this URL to your favorite IPTV player (VLC, Kodi, etc.)

   Xtream Codes API

   Use these credentials in your IPTV app:

   Server: http://localhost:9191
   Username: your_dispatcharr_username
   Password: your_dispatcharr_password
   

   Compatible with TiviMate, IPTV Smarters, and other XC clients.

   HDHomeRun

   For Plex, Emby, or Jellyfin:

   Device URL: http://localhost:9191/hdhr/discover.json
   

   Your media server will auto-discover Dispatcharr as a tuner.

What’s Next?

Configure EPG

Add electronic program guide data for a full TV experience

Set up profiles

Configure transcoding and streaming options

Integrate with Plex

Connect Dispatcharr to your Plex Media Server

Explore features

Learn about advanced channel management

Troubleshooting

Container won't start

Check the logs to see what’s wrong:

docker logs dispatcharr

Common issues:

• Port 9191 already in use - change to -p 9192:9191
• Insufficient memory - ensure at least 2GB RAM available

Can't access the web interface

1. Verify the container is running:
   docker ps | grep dispatcharr
   
2. Check if port 9191 is accessible:
   curl http://localhost:9191
   
3. If using Docker Desktop, ensure port forwarding is enabled

Channels not loading

1. Check M3U account status in Settings → M3U Accounts
2. Click Refresh to manually trigger a channel import
3. Verify your M3U URL is accessible from the container:
   docker exec dispatcharr curl -I <your-m3u-url>
   

For detailed installation options including Docker Compose and bare metal deployment, see the Installation Guide.