Theme Park gives the web pages of many homelab apps a custom look. This page shows you how to install the Theme Park app in Deployrr. It also shows how to theme an app that sits behind Traefik, using qBittorrent as the example.
Before you start
Section titled “Before you start”- Deployrr is installed and you have a Docker folder. See the Quick start.
- For the Traefik method, the app you want to theme is reachable through Traefik with your own domain, and Traefik is installed.
- You know how to edit files in your Docker folder. The
custom.ymlpage explains where the folder and its files are.
Part 1: Install the Theme Park app
Section titled “Part 1: Install the Theme Park app”Do this part if you want to run your own Theme Park server.
-
Open Deployrr.
-
Go to Apps > Browse Apps.
-
Select Theme Park in the list, then choose Install.
-
When Deployrr asks for the web interface port, enter a port or accept the default of
82. -
Wait for the install to finish. Deployrr shows a note with a link to the Theme Park setup guide for self-hosting:
https://docs.theme-park.dev/setup/#selfhosting -
Follow that guide to enable a theme in each app you want to change. The settings differ for each app, so use the Theme Park guide for your app.
Part 2: Theme an app through Traefik
Section titled “Part 2: Theme an app through Traefik”Do this part if the app is behind Traefik and you want the theme added by Traefik. This method needs no Theme Park container. Replace HOSTNAME with your server’s hostname everywhere below. To see the themes you can pick, read UDMS part 25: Available themes (manual setup, background only, so file paths and settings differ from Deployrr).
-
Go to the Traefik rules folder for your server. It is inside your Docker folder:
appdata/traefik3/rules/HOSTNAME/ -
Create a new file named
theme-qbittorrent.ymlin that folder. -
Put this in the file:
http:middlewares:theme-qbittorrent:plugin:traefik-themepark:app: qbittorrenttheme: aquamarineChange
appto the app you want to theme. Changethemeto the theme you want. Use one file per app. -
Open the Traefik file in your Docker folder:
compose/HOSTNAME/traefik.yml -
Find the
command:section. Find the line# - PLUGINS-PLACEHOLDER-DO-NOT-DELETEin it. -
Add these two lines below it, at the same indent as the lines around them:
- --experimental.plugins.traefik-themepark.modulename=github.com/packruler/traefik-themepark- --experimental.plugins.traefik-themepark.version=v1.4.2Leave the placeholder line where it is.
v1.4.2is the latest plugin version at the time of writing. If you add CrowdSec later, Deployrr puts its lines right under the placeholder, above yours. Both stay. -
Open the file that holds the Traefik settings for your app. Most apps, including qBittorrent, have a file named
app-APPNAME.ymlinappdata/traefik3/rules/HOSTNAME/. For qBittorrent it isapp-qbittorrent.yml.-
In an
app-APPNAME.ymlfile, addtheme-qbittorrentas a new line under themiddlewares:list:- theme-qbittorrent -
A few apps, such as Traefik itself, OAuth and Authelia, use Traefik labels in their file in
compose/HOSTNAME/instead. For those, find the line that contains.middlewares=. Add the theme after the existing value, with a comma between them:- "traefik.http.routers.NAME-rtr.middlewares=EXISTING_VALUE@file,theme-NAME@file"Keep the router name and the existing value that are already on your line. Only add
,theme-NAME@fileat the end of the value.
-
-
Save all files. Traefik picks up new and changed files in the top level of the rules folder on its own. Files in subfolders are not read.
-
Recreate Traefik so it loads the plugin. The change to
traefik.ymlneeds this step. Thedcrecalias comes from Bash aliases:Terminal window dcrec traefik
qBittorrent: allow the theme to load
Section titled “qBittorrent: allow the theme to load”qBittorrent blocks styles from other sites unless you allow them.
-
Open the qBittorrent web page and log in.
-
Go to Tools > Options > WebUI.
-
Find Add custom HTTP headers. Add this header as one line:
content-security-policy: default-src 'self'; style-src 'self' 'unsafe-inline' theme-park.dev raw.githubusercontent.com use.fontawesome.com; img-src 'self' theme-park.dev raw.githubusercontent.com data:; script-src 'self' 'unsafe-inline'; object-src 'none'; form-action 'self'; frame-ancestors 'self'; font-src use.fontawesome.com; -
Save the options.
Check it worked
Section titled “Check it worked”- Open your app at its Traefik address.
- Reload the page with Ctrl+F5 to skip the browser cache.
- The page shows the theme you chose.
If the page looks unchanged or Traefik fails to start, read the Traefik log. Run traefiklogs from Bash aliases. Press Ctrl+C to stop.
If you run Traefikify again for the app and choose to overwrite its file, or remove the app from Traefik and add it back, Deployrr writes a new app-APPNAME.yml without your theme line. Add the line again afterwards. If you change the app’s login method, check that the theme line is still in the middlewares: list.

