Container Overrides

If you want to specify custom container Compose settings or only change certain values (without having to modify the Compose files) and persist your own custom settings (such as environment variables), you can create a docker-compose.override.yml file located at /opt/hms-docker/docker-compose.override.yml with only the settings you want to override or merge.

Documentation on how to do this can be found here: Merge | Docker Docs

Here is a basic example of this file (assuming Sonarr, Radarr, and Plex are enabled) that will not override any settings:

services:
  sonarr:
  radarr:
  plex:
  ...

Only enabled containers must be specified in this file.

If a container is not enabled but is specified in this override file, it will fail to validate and throw an error.

To resolve, remove the invalid item from the override file.

If you want to check the final Compose configuration after modification of the override file, you can run:

sudo docker compose config

Private Internet Access (PIA)

The Deluge and qBittorrent containers have native support for the VPN provider Private Internet Access (PIA).

These containers also support port forwarding through PIA, but this means you will only be able to connect to endpoints that support port forwarding.

For more information on this port fowarding feature, see Question 15 (Q15) here: Binhex Documentation

In order to enable this port forwarding, you will need to add the following to the “override” file specified above (/opt/hms-docker/docker-compose.override.yml):

services:
  qbittorrent:
    environment:
      - VPN_PROV=pia
      - STRICT_PORT_FORWARDING=yes
  deluge:
    environment:
      - VPN_PROV=pia
      - STRICT_PORT_FORWARDING=yes