Profilarr is a companion application for Radarr and Sonarr, designed to manage Custom Formats, Quality Profiles, and release scoring. Profilarr v2 introduces a new architecture with a dedicated Parser service for accurate release parsing and scoring.

Profilarr v2 ensures your media downloads match your preferred quality, codec, HDR, streaming‑service source, and fallback rules.

Ensures downloads match preferred settings such as resolution, codec, HDR, audio, streaming source, and fallback behavior.

Fine‑tuned scoring for:

• Streaming services (Netflix, Prime, Apple TV+, Disney+, Max, Hulu, Paramount+, Peacock)
• HDR formats (HDR10, HDR10+, Dolby Vision)
• Audio formats (Atmos, DTS‑HD MA, TrueHD)
• Codecs (x264, x265, HEVC)
• Repack tiers
• Scene releases
• Blu‑ray sources

Syncs profiles and CFs directly. Supports push/pull sync modes and automatically updates Arr apps when profiles change.

• Docker installed
• Profilarr v2 + Profilarr Parser containers running
• Radarr/Sonarr reachable from Profilarr
• .env containing:
  • PROFILARR_API_KEY
  • TZ, PUID, PGID
  • Domain/hostname variables

  profilarr:
    container_name: profilarr.${HOST_NAME}
    hostname: profilarr.${HOST_NAME}.lan
    image: ghcr.io/dictionarry-hub/profilarr:latest
    environment:
      TZ: ${TZ}
      PUID: ${PUID}
      PGID: ${PGID}
      AUTH: off
      ORIGIN: https://profilarr.${DOMAINNAME}
    networks:
      - mediaserver
    ports:
      - ${PROFILARR_PORT}:6868
    volumes:
      # Uncomment if you want Profilarr to interact with Docker directly
      # - /var/run/docker.sock:/var/run/docker.sock
      - ${DOCKERDIR}/profilarr/config:/config
      - ${DOCKERDIR}/logs/profilarr:/var/log
    restart: always
    security_opt:
      - no-new-privileges:true
    labels:
      ## Watchtower enabled?
      - "com.centurylinklabs.watchtower.enable=true"
      ## Homepage Labels
      - "homepage.group=Media"
      - "homepage.name=profilarr"
      - "homepage.icon=profilarr.png"
      - "homepage.href=https://profilarr.${DOMAINNAME}/"
      - "homepage.description=custom format / quality profile management tool"
      ## Homepage Widget
      - "homepage.widget.type="
      - "homepage.widget.url=http://profilarr.${HOST_NAME}:6868"
      - "homepage.widget.key=${PROFILARR_API_KEY}"

Navigate to:

http://<your-ip>:6868

If you turned auth on Create your username and password.
Choose Complete Setup.

• Name: Sonarr
• Type: Sonarr
• URL: http://sonarr:8989
• API Key: (from Sonarr)
• Test connection if successful, choose Save

• Name: Radarr
• Type: Radarr
• URL: http:/Radarr:Radarr7878
• API Key: (from Radarr)
• Test connection if successful, choose Save

Profilarr v2 requires a specific setup order. You must configure and save each section from top to bottom before Quality Profiles can sync.

This section explains exactly what to select, what to save, and what NOT to sync.

Profilarr v2 requires Media Management to be saved before Quality Profiles can sync. You do not sync Media Management — you only initialize it.

1. Go to Media Management
2. Select the default Dictionarry configs for:
   • Naming
   • Quality Definitions
   • Media Settings
3. Set Trigger = Manual
4. Click Save
5. Do NOT click Sync if you wish to keep your Sonarr / Radarr media management settings

Note: Selecting configs only initializes the section. Leaving Trigger = Manual ensures Profilarr never overwrites your naming or media settings.

Delay Profiles protect you from early uploads, fake releases, and low‑quality sources. These change occasionally, so scheduled sync is ideal.

1. Go to Delay Profiles
2. Select the Dictionarry delay profiles
3. Set Trigger = Schedule
4. Use a daily cron schedule: 0 0 * * *
5. Click Save
6. Click Sync

This is where you choose the actual profiles Radarr and Sonarr will use.

Recommended profiles:

• 1080p Balanced
• 2160p Balanced
• 720p Quality (fallback for older shows)

Profilarr v2 automatically syncs the Custom Formats required by these profiles. You do NOT need to sync CFs separately.

1. Go to Quality Profiles
2. Select:
   • 1080p Balanced
   • 2160p Balanced
   • 720p Quality
3. Set Trigger = Schedule
4. Use a daily cron schedule: 0 0 * * *
5. Click Save
6. Click Sync

Profilarr v2 uses new CF IDs and new quality tier IDs.

You MUST reassign profiles:

Settings → Quality → Assign Profilarr v2 profiles

Settings → Quality → Assign Profilarr v2 profiles

Backup:

• config.yaml
• profilarr.db

Weekly backups recommended.

1. Start a new Profilarr container
2. Stop it
3. Copy your old config files into the new container’s config directory
4. Start the container again

• Missing parser container → CFs won’t load
• Old v1 profiles → incorrect scoring
• Cache issues → UI stuck in light mode
• Incorrect Arr URLs → sync fails

Check logs in:

/var/log/profilarr

• Profilarr Discord
• GitHub Issues
• Dictionarry documentation