Skip to main content
TorBox Media Center is configured entirely through environment variables. You can set these in a .env file or pass them directly to Docker.

​
Required variables

​
TORBOX_API_KEY
string
required
Your TorBox API key used to authenticate with TorBox. You can find this in your TorBox account settings.This variable is required for the application to function.

​
Mount configuration

​
MOUNT_METHOD
string
default:"strm"
The mounting method to use for your media files.Valid values:
  • strm - Creates .strm text files that point to your media (recommended for Jellyfin/Emby)
  • fuse - Creates a virtual filesystem using FUSE (recommended for Plex/VLC/other players)
See Mount methods for detailed information about each option.
​
MOUNT_PATH
string
default:"./torbox"
The filesystem path where your media files will be accessible.Docker considerations:
  • This path should match the container’s mount point (typically /torbox)
  • The path must be accessible to other applications like Plex or Jellyfin
  • You need to map this path to your host system using Docker volumes
Local installation:
  • The path must exist and be owned by the user running the application
  • Common paths: /home/username/torbox or ~/torbox
​
MOUNT_REFRESH_TIME
string
default:"normal"
How frequently the application checks for new files in your TorBox account.Valid values:
  • 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
  • instant - Every 6 minutes (requires ENABLE_METADATA=true, may cause rate limiting)
The instant refresh time may cause rate limiting issues with the TorBox API. When combined with metadata scanning, it automatically falls back to fast refresh time.

​
Metadata and organization

​
ENABLE_METADATA
boolean
default:"false"
Enable automatic metadata scanning and organization of your media files.When enabled (true):
  • TorBox attempts to identify each file using the Metadata Search API
  • Files are automatically organized into movies or series folders
  • Files are properly named for media server recognition
  • Unlocks the instant refresh time option
  • You may encounter 429 (rate limit) errors during heavy scanning
When disabled (false):
  • All video files are placed in the movies folder without scanning
  • Faster processing with no API rate limits
  • Better for users who manually organize their libraries
Metadata scanning is automatically disabled when RAW_MODE=true.
​
RAW_MODE
boolean
default:"false"
Present files in their original structure, similar to WebDAV.When enabled (true):
  • Files appear in the same structure as your TorBox downloads
  • No automatic organization or renaming
  • ENABLE_METADATA is automatically disabled
  • Useful for advanced users who want full control
When disabled (false):
  • Files are organized into movies and series folders
  • Metadata scanning is available (if enabled)

​
Configuration examples

​
Using a .env file

Create a .env file in your project directory:
.env
TORBOX_API_KEY=your_api_key_here
MOUNT_METHOD=strm
MOUNT_PATH=/torbox
MOUNT_REFRESH_TIME=normal
ENABLE_METADATA=false
RAW_MODE=false

​
Using Docker run command

docker run -it -d \
    --name=torbox-media-center \
    --restart=always \
    --init \
    -v /home/$(whoami)/torbox:/torbox \
    -e TORBOX_API_KEY=your_api_key_here \
    -e MOUNT_METHOD=strm \
    -e MOUNT_PATH=/torbox \
    -e MOUNT_REFRESH_TIME=normal \
    -e ENABLE_METADATA=false \
    anonymoussystems/torbox-media-center:latest

​
Using Docker Compose

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/user/torbox:/torbox
    environment:
      - TORBOX_API_KEY=your_api_key_here
      - MOUNT_METHOD=strm
      - MOUNT_PATH=/torbox
      - MOUNT_REFRESH_TIME=normal
      - ENABLE_METADATA=false
    image: anonymoussystems/torbox-media-center:latest

​
With FUSE mount method

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/user/torbox:/torbox
    devices:
      - /dev/fuse:/dev/fuse
    environment:
      - TORBOX_API_KEY=your_api_key_here
      - MOUNT_METHOD=fuse
      - MOUNT_PATH=/torbox
      - MOUNT_REFRESH_TIME=normal
    cap_add:
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    image: anonymoussystems/torbox-media-center:latest

Build docs developers (and LLMs) love

Get started for freeTalk to us