Beyond setup
Troubleshooting
Start with the failing service, then check its address, access and reported error. These checks cover the most common setup and daily-use problems.
A service will not connect
- Open its exact address in Safari on the same device and network. If it fails there too, check the server, port, DNS, firewall and VPN.
- Allow Managerr’s Local Network permission for LAN servers.
- Check the selected service type, port and base path. Enter the base address without an API endpoint or query string.
- Copy the API key again from that service. For Seerr, use the owner’s key. For Tautulli, ensure the API is enabled.
- Check custom proxy headers and HTTPS certificate trust, then run Test Service again.
See Reaching your servers and Reverse proxies & headers for detailed setup steps.
Use the error to choose the next check
- 401 or 403
- Check the service key, permissions and proxy access policy. A proxy may reject a request before the service receives it.
- 404 or an unexpected response
- Check the service type and base path. A proxy may be returning a web page or login screen where Managerr expects API data.
- Connection refused or timeout
- Confirm the service is running and listening on the address and port you entered. Check network reachability, VPN routing and firewall rules.
- Certificate error
- Check the HTTPS hostname, expiry and trust chain. Managerr does not ignore certificate errors.
- Redirect error
- Use the final address directly. Authenticated redirects to a different scheme, host or port are refused.
Save is disabled, or a view is empty
Save becomes available after a successful test of the current editor values. If you edit any field afterwards, test again. A successful test confirms that connection at that time; individual features can still depend on permissions and server configuration.
For empty views, check that the service is enabled in Settings → Services, then clear the service and content filters. Confirm that the relevant content exists in the service’s own web interface.
Different services supply different content. Prowlarr supplies indexer search, Seerr supplies requests and discovery, and Tautulli supplies playback. Sonarr, Radarr and Lidarr supply media libraries, releases and download queues. Home hides empty sections; check Arrange Home for sections you switched off.
Downloads, imports and artwork
For a stalled download, open the queue entry and read its warning or error. Check the service’s queue and download-client logs. For an import failure, check the server’s history and logs, file matching, permissions and paths as seen by that server.
For a pending command, check the command status and the server’s logs before repeating it. Accepted work can still be queued or fail later.
If artwork is missing, check whether it loads in the service’s web interface. Confirm that the device can reach the server or artwork host. You can clear saved artwork from Settings → Backup and Reset → Image Cache; images are loaded again as you browse.
Reminders, widgets and backups
For missing reminders, allow notifications for Managerr in system Settings, then set the reminder again in Calendar. Open the app to fetch changed release dates. See Notifications for timing and limits.
For stale widgets, open Managerr, wait for a successful refresh and check that the relevant services are enabled. Background updates depend on the operating system. See Widgets and Shortcuts.
For a restore failure, confirm that the file has finished downloading in Files and that the passphrase is correct. A backup from a newer version can require an app update. Settings-only backups have no credentials to transfer; add missing API keys and custom headers after restoring. See Backup and Reset.
Find the relevant log
Reproduce the problem once and note the time, service, app version and exact error. For connection failures, check the proxy access/error logs and the service log. For searches and imports, check the media manager and download client. For requests, check Seerr’s logs; for playback, check Tautulli and Plex.
Use the service’s own documentation for server configuration. These guides provide Managerr support without an email address. Keep API keys, tokens and custom header values out of screenshots or logs you share elsewhere.