How to Set Up Profilarr with Docker Compose (Step-by-Step Video)

Profilarr logo with the words install with Docker Compose, better quality profiles

For educational purposes only. This guide shows how to install self-hosted software on your own hardware. I don't condone piracy: only use these apps with media you own or have the right to use, and follow the law where you live. Back up your data first. Full disclaimer

Updated 16 November 2026 Tested with: Profilarr 2.3.1

Profilarr sets up Radarr and Sonarr’s quality profiles for you. Instead of copying dozens of custom formats from forum posts, you link a ready-made database, tick a profile like 1080p Balanced, and Profilarr pushes everything into Radarr: the profile, around 100 custom formats and their scores. When the database improves, your Radarr updates by itself.

This guide sets up Profilarr with Docker Compose in six short steps. It takes about 15 minutes.

Why bother? Out of the box, Radarr only knows quality names like “Remux-1080p” and “WEBDL-1080p”. It can’t tell a clean web copy from a tiny x265 re-encode or a release from a group known for fakes. Custom formats fix that, but setting them up by hand is a lot of work. Profilarr does it in a few clicks.
On this page (13 sections)

Watch: install Profilarr with Docker Compose

The video has subtitles at the bottom and no sound. It was recorded on a clean test install of Profilarr 2.3 connected to a test Radarr, syncing the 1080p Balanced profile.

See what Profilarr changes

Press Search to see which copy of a film Radarr grabs on its own. Then switch to With Profilarr, search again and try A few days later. The scores come from Radarr itself, after the profile in this guide was synced into it. Under the demo is the generator you’ll use in Step 1.


Open the generator full screen

What you need to set up Profilarr with Docker Compose

  • A computer or NAS running Docker. New to Docker? The Docker install guide covers Windows, Mac and Linux.
  • Radarr (version 5 or newer) and/or Sonarr (version 4 or newer), already running.
  • Nothing else. Profilarr uses about 250 MB of memory with the parser.
Used Profilarr before? This guide is for Profilarr 2, a complete rewrite. It can’t import a Profilarr 1 setup, so start with an empty config folder. Synology boxes on the old 3.10 kernel can’t run Profilarr 2 at all.

Step 1: Make your compose file

In the generator, enter your PUID, PGID, time zone and server IP. Leave Updates on :2: you get every 2.x update, but never a surprise jump to a future 3.0. Then:

mkdir -p ~/profilarr && cd ~/profilarr

Save compose.yaml and .env there, and run the commands from the Commands tab. Profilarr opens at http://YOUR-SERVER-IP:6868.

Step 2: Create your login

The first screen asks you to create an admin account. Pick a username and a password of at least 8 characters, and click Create Account. Unlike most arr apps, Profilarr has a login switched on from the start.

Step 3: Check the database

The database is where the profiles come from. Profilarr links Dictionarry, its own database, for you on first start. Open Databases to check: you should see 11 quality profiles and 261 custom formats. It pulls updates every hour.

Profilarr Databases page with the Dictionarry database linked: 11 quality profiles, 261 custom formats, hourly sync
Dictionarry is linked out of the box.

Prefer the TRaSH Guides? Click + on the Databases page to link their database instead. This guide sticks with Dictionarry.

Step 4: Add Radarr and Sonarr

  1. In Radarr, go to Settings → General and copy the API Key.
  2. In Profilarr, open Arrs and click Add Instance.
  3. Name: Radarr. Type: Radarr. URL: the one from the generator’s Connect tab, like http://192.168.1.10:7878. Paste the API Key.
  4. Click Test Connection. When it works, Profilarr shows Radarr’s version. Click Save.
  5. Do the same for Sonarr, with port 8989 and Sonarr’s API key.
Profilarr Add Instance form for Radarr with URL http://radarr:7878 and a Connected to Radarr message
Arrs → Add Instance. Here Profilarr shares Radarr’s Docker network, so the URL is http://radarr:7878.

Step 5: Choose what to sync

Open Arrs → Radarr → Sync. There are three boxes, and the order matters: Profilarr won’t sync a quality profile until a delay profile is set.

1. Media Management. Pick Dictionarry / Radarr in all three boxes (Naming, Quality Definitions, Media Settings) and click Save.

Profilarr Sync tab Media Management with Dictionarry / Radarr chosen for naming, quality definitions and media settings
Media Management: Dictionarry / Radarr in all three.

2. Delay Profile. Dictionarry’s delay profile prefers torrents and waits 6 hours before every download. If that’s not how you work, change it first: go to Delay Profiles → Radarr, set it how you like (for example Prefer Usenet and 0 hours for both), and click Save Changes. Your change is kept when the database updates. Then back on the Sync tab, tick Radarr under Delay Profiles and click Save.

Profilarr Edit Delay Profile set to Prefer Usenet with 0 hour delays
Delay Profiles → Radarr, changed to match how I download.

3. Quality Profiles. Tick the profile you want and click Save. Not sure? Start with one of these:

  • 1080p Balanced: 1080p web copies, about 4 to 8 GB per film. The best start for most people, and the one in the demo.
  • 1080p Quality: top-quality 1080p encodes, about 10 to 15 GB per film.
  • 2160p Balanced: 4K web copies with HDR, about 15 to 30 GB per film. Use it if you want 4K films.
Profilarr Sync tab with the Radarr delay profile and the 1080p Balanced quality profile ticked
Delay profile Radarr, quality profile 1080p Balanced.

Finally, set each Trigger to On Pull, so Radarr gets every database update automatically, and click Sync in each box. Then do the same for Sonarr, using the Sonarr options.

What syncing changes in Radarr: it adds the profile and its custom formats, and it replaces your naming pattern, quality sizes and default delay profile with Dictionarry’s. Renaming gets switched on too, so new downloads get tidy names. Your existing profiles and films aren’t touched.

Step 6: Check it’s working

Back on Arrs, your Radarr card now lists the profile, the delay profile and all three media settings.

Profilarr Arrs page showing Radarr with 1080p Balanced, delay profile and media management synced
Everything synced to Radarr.

In Radarr, Settings → Profiles now has 1080p Balanced. New films use it when you pick it in the Add Movie screen. To move your existing films over, go to Movies, click Select Movies, tick them, click Edit and set Quality Profile to 1080p Balanced. 🎉

Optional: Upgrades

Radarr already grabs better copies as they appear in its RSS feed. Profilarr’s Upgrades tab is for catching up an existing library, for example after you switch everything to a new profile. It searches slowly on purpose (one film every 10 minutes) to keep your indexers happy. Most people can leave it off.

If something’s wrong

  • “Quality profiles require a delay profile.” Tick a delay profile, click Save, then save the quality profile again.
  • Test Connection fails. Check the URL and API key. Use your server’s IP, not localhost: inside the Profilarr container, localhost means Profilarr itself. If Radarr runs behind Gluetun and you share its network, use http://gluetun:7878.
  • Downloads now wait hours before starting. That’s Dictionarry’s delay profile. Change it as in Step 5 and click Sync again.
  • Radarr grabs nothing for a film. No copy scored above the minimum. 1080p Balanced only wants web copies, so for older films with no web release, try 1080p Quality on those films.
  • Login doesn’t work behind a reverse proxy. Tick the reverse proxy box in the generator. It adds ORIGIN, which has to match the address in your browser exactly.

Updating Profilarr

cd ~/profilarr
docker compose pull && docker compose up -d

Frequently asked questions

What does Profilarr do?

It copies ready-made quality profiles and custom formats from a database such as Dictionarry into Radarr and Sonarr, and keeps them up to date when the database changes.

Is Profilarr 2 compatible with Profilarr 1?

No. Profilarr 2 is a rewrite and cannot import a Profilarr 1 setup, so start with an empty config folder.

Do I need the parser container?

Only for the Testing pages that score real release names. Linking, syncing and upgrades work without it.

Will Profilarr change my Radarr settings?

Yes, for what you choose to sync: it adds the profile and custom formats, and replaces the naming pattern, quality sizes and default delay profile with the database versions. Existing profiles and films are not touched.

Thank you

Profilarr is free and open source (AGPL-3.0), made by santiagosayshey and the Dictionarry team, who also look after the Dictionarry database. If it saves you an evening of custom formats, give the project a star on GitHub.

Related guides: Radarr · Sonarr · Prowlarr · Complete Arr Stack

If this guide helped you, consider buying me a coffee. It helps keep guides like this one coming.

☕Buy me a coffee

Get new guides by email

About one email a month: new step-by-step guides and card releases. No spam, unsubscribe any time.

I'll send a confirmation email first. See the privacy policy.

Leave a Reply