Skip to main content
This guide covers the most common issues you may encounter when using TorBox Media Center and their solutions.

​
Common problems

This can usually happen due to one of the following:

​
Processing or scraping errors

Check your logs for any errors during the processing/scraping phase where the media center attempts to get your files.
docker logs torbox-media-center
Look for error messages related to API authentication, network issues, or file processing failures.

​
Incorrect folder permissions

Make sure that Docker (or the user running Docker or the Python script) has access to the folder you have set.Fix using chown:
sudo chown -R $(whoami):$(whoami) /home/$(whoami)/torbox
This command recursively changes ownership of the folder to your user, ensuring the application can read and write files.

​
Folder does not exist

If you aren’t using Docker or the easy setup scripts, the mount folder may not exist beforehand. Create the folder first:
mkdir -p /path/to/torbox/folder
When you run Plex, Jellyfin, or Emby inside a Docker container, it runs in its own isolated environment. This creates a path mapping issue where your media files might appear at /torbox/movies inside the TorBox Media Center container while those same files are actually located at /home/user/torbox/movies on your host system.Your media server needs to access files that exist on your real computer (outside Docker), but it’s running inside Docker where the file paths look different. If the permissions aren’t set up correctly or the volumes aren’t mapped properly, the media server won’t be able to read your movie and TV show files.

​
Example configuration

If you have TorBox Media Center files stored at /home/wamy/torbox/movies on your computer and you map it to /torbox/movies inside your Docker container, Plex/Jellyfin/Emby needs to access the files at /home/wamy/torbox/movies not /torbox/movies.TorBox Media Center configuration:This ensures that the files will be available on the host system at /home/wamy/torbox:
docker run -it -d \
  --name=torbox-media-center \
  -v /home/wamy/torbox:/torbox \
  -e MOUNT_PATH=/torbox \
  -e TORBOX_API_KEY=<YOUR_KEY> \
  anonymoussystems/torbox-media-center:latest
Plex/Jellyfin/Emby configuration:This ensures that Plex/Jellyfin/Emby can see the TorBox Media Center files on the host system:
docker run -d \
  --name=jellyfin \
  -v /home/wamy/torbox:/torbox-media-center \
  jellyfin/jellyfin:latest
Then inside your Plex/Jellyfin/Emby container, set the library location to:
  • /torbox-media-center/movies for movies
  • /torbox-media-center/series for TV shows
The key is ensuring both containers have access to the same directory on the host system, even if they mount it at different paths internally.
The FUSE mount is read-only by design. You cannot rename files, delete files, or move them around.

​
Why is it read-only?

This software handles file organization and management automatically based on your TorBox account. The read-only filesystem ensures that:
  • Files are organized correctly according to metadata
  • No accidental modifications break the virtual filesystem
  • The mount stays in sync with your TorBox account

​
How to delete files

To delete a file, simply delete it from your TorBox account at torbox.app. The file will be removed from the mount on the next refresh cycle.

​
File permissions

FUSE files are mounted with 0o444 permissions (read-only for all users), as seen in the source code:
st.st_mode = stat.S_IFREG | 0o444  # Read-only file
This is intentional and cannot be changed.
Files are refreshed on a schedule based on your MOUNT_REFRESH_TIME setting.

​
Default refresh interval

The default is normal, which refreshes every 3 hours. Available options:
  • slowest - Every 24 hours
  • very_slow - Every 12 hours
  • slow - Every 6 hours
  • normal - Every 3 hours (default)
  • fast - Every 2 hours
  • ultra_fast - Every 1 hour

​
Force a refresh

Restart the container to force an immediate refresh:
docker restart torbox-media-center

​
Check the logs

Monitor the logs to see when refreshes occur:
docker logs -f torbox-media-center
Look for log messages indicating file updates and mount operations.

​
Still having issues?

If you continue to experience problems:
  1. Check the Docker permissions guide for permission-related issues
  2. Review the FUSE issues guide for FUSE-specific problems
  3. Contact support at [email protected] or join the Discord server

Build docs developers (and LLMs) love

Get started for freeTalk to us