Troubleshooting

Common troubleshooting

First checks for MediaHub app, desktop playback and Management-panel problems.

MediaHub cannot connect to IPTV

Confirm the account credentials are valid. In a managed deployment, also confirm the provider DNS is correct in Management and restart MediaHub so it can refresh managed configuration.

Managed change did not appear

Completely close and reopen MediaHub. Dynamic branding, controls, restrictions, provider DNS and managed media-server settings are refreshed by compatible managed builds rather than continuously on every screen.

Management cannot build an APK

Open System and confirm the builder requirements report ready, including Python/Pillow, Java/keytool, zipalign, apksigner, writable storage and PHP proc_open.

Desktop player problems

If the desktop build reports that the player started but its control pipe did not become ready, collect the desktop player/mpv log before reinstalling components. The log normally shows whether the player executable started, exited immediately or failed to expose its IPC endpoint.

Ask for help with useful information

Include the MediaHub version, platform, what you expected, what happened instead and the smallest relevant log. Do not post service passwords, signing-key passwords or private deployment tokens publicly.