Docker installation

Docker is the recommended installation method for TorBox Media Center. It simplifies deployment and ensures consistent behavior across different systems.

Prerequisites

Docker installed on your system (installation guide)
A TorBox account on a paid plan (sign up here)
Your TorBox API key from settings

Choose your mount method

TorBox Media Center supports two mounting methods:

STRM (recommended)
FUSE

The STRM method creates small text files (.strm) that point to your media. This method:

Works on all operating systems
Compatible with Jellyfin and Emby
Uses minimal storage (less than 1GB for any library size)
More reliable in Docker environments

Use STRM if you’re running Jellyfin or Emby, or if you’re unsure which method to choose.

Docker run command

STRM
FUSE

docker run -it -d \
    --name=torbox-media-center \
    --restart=always \
    --init \
    -v /home/$(whoami)/torbox:/torbox \
    -e TORBOX_API_KEY=<EDIT_THIS_KEY> \
    -e MOUNT_METHOD=strm \
    -e MOUNT_PATH=/torbox \
    anonymoussystems/torbox-media-center:latest

Replace <EDIT_THIS_KEY> with your actual TorBox API key from torbox.app/settings.

docker run -it -d \
    --name=torbox-media-center \
    --restart=always \
    --init \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    -v /mnt/torbox:/torbox:rshared \
    -e TORBOX_API_KEY=<EDIT_THIS_KEY> \
    -e MOUNT_METHOD=fuse \
    -e MOUNT_PATH=/torbox \
    anonymoussystems/torbox-media-center:latest

The --cap-add SYS_ADMIN parameter gives the container elevated permissions to access the host system’s FUSE device. This is required for the virtual filesystem but should be used with caution. Read more in the Docker documentation.

The --device /dev/fuse parameter provides access to the FUSE device
The :rshared volume flag is required for FUSE mounts
Replace <EDIT_THIS_KEY> with your TorBox API key

Docker Compose

STRM
FUSE

docker-compose.yaml

name: torbox-media-center
services:
    torbox-media-center:
        container_name: torbox-media-center
        stdin_open: true
        tty: true
        restart: always
        volumes:
            - /home/$(whoami)/torbox:/torbox
        environment:
            - TORBOX_API_KEY=<input your api key>
            - MOUNT_METHOD=strm
            - MOUNT_PATH=/torbox
            - RAW_MODE=false
            - ENABLE_METADATA=false
            - MOUNT_REFRESH_TIME=slow
        image: anonymoussystems/torbox-media-center:latest

You can use this compose file with Portainer or run it with docker compose up -d.

docker-compose.yaml

name: torbox-media-center
services:
    torbox-media-center:
        container_name: torbox-media-center
        stdin_open: true
        tty: true
        restart: always
        volumes:
            - /mnt/torbox:/torbox:rshared
        devices:
            - /dev/fuse:/dev/fuse
        environment:
            - TORBOX_API_KEY=<input your api key>
            - MOUNT_METHOD=fuse
            - MOUNT_PATH=/torbox
        cap_add:
            - SYS_ADMIN
        security_opt:
            - apparmor:unconfined
        image: anonymoussystems/torbox-media-center:latest

FUSE requires SYS_ADMIN capability and access to /dev/fuse. Ensure your Docker host supports FUSE.

Volume configurations

The volume mount determines where your media files will be accessible on your host system.

Standard configuration

-v /home/$(whoami)/torbox:/torbox

Files will be accessible at /home/yourusername/torbox on your host system.

Custom host location

-v /mnt/torbox:/torbox

Files will be accessible at /mnt/torbox on your host system.

Custom container path

-v /mnt/torbox:/data
-e MOUNT_PATH=/data

Files stored at /mnt/torbox on the host, but the container uses /data internally. Make sure MOUNT_PATH matches the container path.

Environment variables

Required:

TORBOX_API_KEY - Your TorBox API key from torbox.app/settings

Optional:

MOUNT_METHOD - Either strm or fuse (default: strm)
MOUNT_PATH - Path inside the container where files are mounted (default: /torbox)
MOUNT_REFRESH_TIME - How often to check for new files: slowest (24h), very_slow (12h), slow (6h), normal (3h), fast (2h), ultra_fast (1h), or instant (6min, requires metadata) (default: normal)
ENABLE_METADATA - Enable metadata scanning to organize files into movies/series folders (default: false)
RAW_MODE - Use raw file structure without metadata organization (default: false)

Converting to Docker Compose

If you have a Docker run command and want to convert it to Docker Compose format, use Composerize. Simply paste your Docker run command and it will generate the equivalent compose configuration.

Image tags

latest - Latest stable release (recommended)
main - Bleeding edge from the main branch (for testing)
sha-<hash> - Specific commit version (e.g., sha-bdd4339)

Next steps

After starting the container:

Check the logs to ensure it’s running correctly:
```
docker logs -f torbox-media-center
```
Your media files will appear at the mount path you specified (e.g., /home/yourusername/torbox)
Configure your media server (Jellyfin, Emby, Plex) to use the mounted path:
- Movies: <mount_path>/movies
- TV Shows: <mount_path>/series

See the Troubleshooting guide if files aren’t appearing or your media server can’t access them.

Get Started

Installation

Configuration

Guides

Troubleshooting

Prerequisites

Choose your mount method

Docker run command

Docker Compose

Volume configurations

Standard configuration

Custom host location

Custom container path

Environment variables

Converting to Docker Compose

Image tags

Next steps

Build docs developers (and LLMs) love

Get Started

Installation

Configuration

Guides

Troubleshooting

​Prerequisites

​Choose your mount method

​Docker run command

​Docker Compose

​Volume configurations

​Standard configuration

​Custom host location

​Custom container path

​Environment variables

​Converting to Docker Compose

​Image tags

​Next steps

Build docs developers (and LLMs) love

Prerequisites

Choose your mount method

Docker run command

Docker Compose

Volume configurations

Standard configuration

Custom host location

Custom container path

Environment variables

Converting to Docker Compose

Image tags

Next steps