profilarr

Manage quality profiles, custom formats, and release profiles across your Radarr and Sonarr instances. Define your profiles once with a Git-backed configuration database, then sync them to any number of *arr instances.

Warning

V2 is under heavy development and is NOT ready for production use. Use Profilarr V1 until V2 is ready.

Features

Core

Link - Connect to configuration databases like the Dictionarry database or any Profilarr Compliant Database (PCD)
Bridge - Add your Radarr and Sonarr instances by URL and API key
Sync - Push configurations to your instances. Profilarr compiles everything to the right format automatically

For Users

Ready-to-Use Configurations - Stop spending hours piecing together settings from forum posts. Get complete, tested quality profiles, custom formats, and media settings designed around specific goals
Stay Updated - Make local tweaks that persist across upstream updates. View changelogs, diffs, and revert changes when needed. Merge conflicts are handled transparently
Automated Upgrades - The arrs don't search for the best release, they grab the first RSS item that qualifies. Profilarr triggers intelligent searches based on filters and selectors

For Developers

Unified Architecture - One configuration language that compiles to Radarr/Sonarr-specific formats on sync. No more maintaining separate configs for each app
Reusable Components - Regular expressions are separate entities shared across custom formats. Change once, update everywhere
OSQL - Configurations stored as append-only SQL operations. Readable, auditable, diffable. Git-native version control with complete history
Testing - Validate regex patterns, custom format conditions, and quality profile behavior before syncing

Documentation

See dictionarry.dev for complete installation, usage, and API documenation.

Getting Started

Production

services:
  profilarr:
    image: ghcr.io/dictionarry-hub/profilarr:latest
    container_name: profilarr
    ports:
      - "6868:6868"
    volumes:
      - ./config:/config
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - PARSER_HOST=parser
      - PARSER_PORT=5000
    depends_on:
      parser:
        condition: service_healthy

  # Optional - only needed for CF/QP testing
  parser:
    image: ghcr.io/dictionarry-hub/profilarr-parser:latest
    container_name: profilarr-parser
    expose:
      - "5000"

Note

The parser service is only required for custom format and quality profile testing. Linking, syncing, and all other features work without it. Remove the parser service and related environment variables if you don't need it.

Development

Prerequisites

Git (for PCD operations)
Deno 2.x
.NET SDK 8.0+ (optional, for parser)

git clone https://github.com/Dictionarry-Hub/profilarr.git
cd profilarr
deno task dev

This runs the parser service and Vite dev server concurrently. See CONTRIBUTING.md for architecture documentation.

Environment Variables

Variable	Default	Description
`PUID`	`1000`	User ID for file permissions
`PGID`	`1000`	Group ID for file permissions
`UMASK`	`022`	File creation mask
`TZ`	`Etc/UTC`	Timezone for scheduling
`PORT`	`6868`	Web UI port
`HOST`	`0.0.0.0`	Bind address
`APP_BASE_PATH`	`/config`	Base path for data, logs, backups
`PARSER_HOST`	`localhost`	Parser service host
`PARSER_PORT`	`5000`	Parser service port

License

AGPL-3.0

Profilarr is free and open source. You do not need to pay anyone to use it. If someone is charging you for access to Profilarr, they are violating the spirit of this project.