Backend | MediaManager

General Settings

`API_BASE_PATH`

The url base of the backend. Default is /api/v1.

`CORS_URLS`

Enter a list of origins you are going to access the api from. Example: ["https://mm.example"].

Database Settings

`DB_HOST`

Hostname or IP of the PostgreSQL server. Default is localhost.

`DB_PORT`

Port number of the PostgreSQL server. Default is 5432.

`DB_USER`

Username for PostgreSQL connection. Default is MediaManager.

`DB_PASSWORD`

Password for the PostgreSQL user. Default is MediaManager.

`DB_DBNAME`

Name of the PostgreSQL database. Default is MediaManager.

Download Client Settings

Currently, only qBittorrent is supported as a download client. But support for other clients isn't unlikely in the future.

`QBITTORRENT_HOST`

Host of the QBittorrent API. Default is localhost. Example: qbit.example.com.

`QBITTORRENT_PORT`

Port of the QBittorrent API. Default is 8080. Example: 443.

`QBITTORRENT_USER`

Username for QBittorrent. Default is admin.

`QBITTORRENT_PASSWORD`

Password for QBittorrent. Default is admin.

Metadata Provider Settings

These settings configure the integrations with external metadata providers like The Movie Database (TMDB) and The TVDB.

TMDB (The Movie Database)

TMDB is the primary metadata provider for MediaManager. It provides detailed information about movies and TV shows.

`TMDB_RELAY_URL`

If you want use your own TMDB relay service, set this to the URL of your own MetadataRelay. Otherwise, don't set it to use the default relay.

Default: https://metadata-relay.maxid.me/tmdb.

TVDB (The TVDB)

`TVDB_RELAY_URL`

If you want use your own TVDB relay service, set this to the URL of your own MetadataRelay. Otherwise, don't set it to use the default relay.

Default: https://metadata-relay.maxid.me/tvdb.

MetadataRelay

The MetadataRelay is a service that provides metadata for MediaManager. It acts as a proxy for TMDB and TVDB, allowing you to use your own API keys, but not strictly needing your own because only me, the developer, needs to create accounts for API keys. You might want to use it if you want to avoid rate limits, to protect your privacy, or other reasons. If you know Sonarr's Skyhook, this is similar to that.

Where to get API keys

Get an API key from The Movie Database. You can create an account and generate a free API key in your account settings.

Get an API key from The TVDB. You can create an account and generate a free API key in your account settings.

Directory Settings

`IMAGE_DIRECTORY`

Media images (posters, backdrops) will be stored here. Default is /data/images.

`TV_DIRECTORY`

Location of TV show files. Default is /data/tv.

`MOVIE_DIRECTORY`

Location of movie files. Default is /data/movies.

`TORRENT_DIRECTORY`

Location of torrent files and downloads. Default is /data/torrents.

Email Settings

For sending emails, MediaManager uses the SMTP protocol. You can use any SMTP server, like Gmail or SMTP2GO.

`EMAIL_SMTP_HOST`

Hostname of the SMTP server.

`EMAIL_SMTP_PORT`

Port of the SMTP server.

`EMAIL_SMTP_USER`

Username for the SMTP server.

`EMAIL_SMTP_PASSWORD`

Password for the SMTP server.

`EMAIL_FROM_EMAIL`

Email address from which emails will be sent.

`EMAIL_USE_TLS`

Set to True to use TLS for the SMTP connection. Default is False. For secure connections, use TLS.

Notification Settings

MediaManager can send Notifications via email, ntfy.sh, Pushover and Gotify. You can enable any of these. To enable a notification method, set the corresponding environment variables.

Email

`NOTIFICATION_EMAIL`

If set notifications will be sent via email to this email address. Example: notifications@example.com.

Gotify

`NOTIFICATION_GOTIFY_API_KEY`

API key for Gotify.

`NOTIFICATION_GOTIFY_URL`

Base URL of your Gotify instance. Example: https://gotify.example.com. Note the lack of a trailing slash.

Ntfy

`NOTIFICATION_NTFY_URL`

URL of your ntfy instance + the topic. Example https://ntfy.sh/your-topic.

Pushover

`NOTIFICATION_PUSHOVER_API_KEY`

API key for Pushover.

`NOTIFICATION_PUSHOVER_USER`

Username for Pushover.

Build Arguments (Dockerfile)

`VERSION`

Labels the Docker image with a version. Passed during build (e.g., by GitHub Actions). Frontend uses this as PUBLIC_VERSION. Example (in build command): docker build --build-arg VERSION=1.2.3 .