Skip to content

Troubleshooting

Stream Failover not working

  • Check if the Stream Profile (default and/or for the channel) is set to redirect. Stream failover will not work for redirect

Will you implement X new feature?

  • Check existing feature requests in our discord or github. If it's not already requested, feel free to request.

Does dispatcharr support hardware acceleration?

Logos are missing in Plex

  • Plex does not support cached logos. Add ?cachedlogos=false to the end of your EPG to bypass logo caching.

How do I output to XC API?

  • There must be at least one user set up with an XC password
  • For URL, use your IP address and port http://{your_ip_here}:9191
  • Username is your user's username
  • Password is the XC password set for the user

How do I turn on debug logs?

  • Add this to your compose/environmental variables: DISPATCHARR_LOG_LEVEL=debug

I got new credentials (or URL) from my provider, what should I do?

  1. Make a backup!
  2. Remove URL from Settings >>> Stream Settings >>> M3U Hash Key
    • Add all other hash options
  3. Once re-hashing has finished, change the settings in your M3U account
  4. Refresh the account
  5. Once refresh is complete, change your hash settings back

I changed my network settings and accidently locked myself out. How can I reset it?

  1. Access the CLI of the container
  2. cd to /app
  3. Run the following command: python manage.py reset_network_access

How can I make a backup of the database?

See Backup & Restore

How can I password protect my M3U to share over the internet?

  1. Set up your reverse proxy as shown in the docs
  2. In dispatcharr at Settings > Network Access, restrict M3U / EPG Endpoints to your local network only (example: 192.168.1.0/24)
  3. Set up a user with XC password on the Users page if you haven't already done so
  4. Use the following m3u link format to share with your users: https://hostname/get.php?username=XCUSERNAME&password=XCPASSWORD
  5. And this format for epg: https://hostname/xmltv.php?username=XCUSERNAME&password=XCPASSWORD

Why are there connections showing on the dispatcharr stats page when no one is watching or connected?

This is a tricky issue that the dispatcharr team has been trying to nail down, however there are some reasons that have been identified:

  • A bug or error in the client that fails to close the connection to dispatcharr
  • Passing dispatcharr through a Cloudflare tunnel. Some of our users have found changing the following Cloudflare settings to be helpful:
    • Idle Connection Expiration - 10 seconds
    • Max TCP Keepalives - 3 seconds
    • TCP Keepalive Interval - 10 seconds
    • In dispatcharr, set the Channel Shutdown Delay to 3 seconds

If you can reliably reproduce this issue and believe it isn't due to one of the reasons listed above, please reproduce it while capturing debug logs and submit an issue on our Github or share with the team in our Discord channel

How do I update my container (using compose)?

  1. Open a terminal on the host
  2. Run the following command: docker compose -f /path/to/docker-compose.yml pull
  3. Run the following command: docker compose -f /path/to/docker-compose.yml up -d

I'm getting a message about hardware support for NumPy. What should I do?

If you're running a QEMU/KVM based Hypervisor (such as Proxmox), change your VM hardware type to "Host" or to "x86_v2" from "q35"

If you're running on old hardware (processor from ~2009 or older), add the following under your "environment" section in your docker compose: - USE_LEGACY_NUMPY=true

How do I access VOD?

To use Video-on-Demand (VOD), you must import your IPTV account into Dispatcharr with the Xtream Codes account type and credentials. Some sources refer to this as "API" as well.

To use VOD in a third party client/app, you must also export out of Dispatcharr using Xtream Codes credentials. (see: How do I output to XC API?)

Multicast streams are not working

Multicast streams require dispatcharr to be run in host network mode or use macvlan.

Additionally, if multiple network interfaces are available, you should add ?localaddr=[interface-ip] to the end of your stream URL.

Example

udp://239.1.2.3:4567?localaddr=0.0.0.0

How do I remove all VOD from dispatcharr?

  1. In the M3U & EPG manager page, click the edit icon for any account that provides VOD (only XC account types can provide it)
  2. Toggle Enable VOD Scanning on
  3. Click the Groups button
  4. Under the VOD - Movies and VOD - Series tabs, deselect all Groups
  5. Click Save and Refresh
  6. After the refresh completes, toggle the Enable VOD Scanning option off
  7. Repeat for any other accounts if necessary