Install the FilmFetch Downloader

This guide explains how to install the filmfetch/deliveryclient:latest Docker container on Windows Server, Synology and QNAP NAS devices using their graphical interfaces. The container needs a volume mapping and three environment variables to work.

Last updated 21 May 2025

~10 min

Martijn van der Horst

Before you begin

FilmFetch API key and Client ID
Find these in the FilmFetch portal, or ask support@filmfetch.net
Docker installed and running
Admin rights on your device
A local folder with read/write access for downloads

Container settings

Setting	Value
Image	`filmfetch/deliveryclient:latest`
Volume mapping	local folder such as `/volume1/downloads/filmfetch` container path `/D/`
Environment	DELIVERY_API_TYPE=Production DELIVERY_API_KEY=your-api-key DELIVERY_CLIENT_ID=your-client-id

Replace your-api-key and your-client-id with your actual FilmFetch credentials.

Choose your platform

Open Docker in DSM

Go to Registry

Click the Registry tab on the left.

Search for image

Search for filmfetch/deliveryclient.

Download image

Select the latest tag and click Download.

Launch container

Click Launch and choose Run this container.

General settings

Name the container filmfetch-client, and (optionally) add a description.

Enable auto-restart

Check the Enable auto-restart option.

Volume settings

Add a folder from your NAS (e.g. /volume1/downloads/filmfetch) and map it to container path /D/.

Environment variables

Add the three environment variables listed in Container settings above.

Apply and run

Review your settings, click Apply, and confirm the container is running.

Open Container Station

Launch the Container Station application from your QNAP desktop.

Create and search

Click Create, search for filmfetch/deliveryclient, and choose latest.

Configure installation

Click Install and name the container filmfetch-client.

Shared Folders & Environment

Mount e.g. /share/Container/filmfetch to /D/. Add the three required environment variables.

Deploy

Click Create to deploy, then use the Log tab to verify it runs.

Prerequisites

Windows Server 2019 or later with Docker installed.
A folder for downloads, e.g. C:\FilmfetchDownloads.

Via Docker CLI

Open PowerShell as Administrator and run the following commands.

powershell

mkdir C:\FilmfetchDownloads

powershell

docker run -d ^
  --name filmfetch-client ^
  --restart unless-stopped ^
  -v C:\FilmfetchDownloads:/D ^
  -e DELIVERY_API_TYPE=Production ^
  -e DELIVERY_API_KEY=your-api-key ^
  -e DELIVERY_CLIENT_ID=your-client-id ^
  filmfetch/deliveryclient:latest

powershell

docker ps

Via Docker Desktop (GUI)

Open Images tab, search on Docker Hub, pull latest, click Run, name filmfetch-client, map Host volume C:\FilmfetchDownloads to container /D, add the three environment variables, optionally enable auto-restart, and click Run Container.

Final notes

The /D/ folder must have read/write permissions for the container.
Logs and restart controls are available through Docker or Container Station.

Troubleshooting

Container starts and immediately stops

Check that your API key and Client ID are correct. Inspect the container logs in your graphical interface to see specific error messages preventing startup.

No files appear in my folder

Verify that the volume mount correctly points your local folder to /D/ internally. Also ensure the container process has read/write permissions to that host directory.

Where do I find my API key and Client ID?

Log in to the FilmFetch portal and navigate to Developer Settings. If you don't have access, contact support@filmfetch.net.

Back to all docs