recyclarr

recyclarr

Official

Docker app from tritones' Repository

Overview

A command-line application that will automatically synchronize recommended settings from TRaSH guides to your Sonarr/Radarr instances. As of v8.4.0 the `:latest` tag is no longer supported. Please use a specific version tag instead. As of v2.3.0 the image is rootless and the Nobody user must be passed via the Extra Parameter '--user="99:100"'. The PUID and PGID environment variables are no longer used and must be removed. Full instructions here: https://github.com/recyclarr/recyclarr/wiki Formerly named "Trash Updater".

Recyclarr

GitHub License Build Workflow Status CodeQL GitHub Release Discord

A command-line application that will automatically synchronize recommended settings from the TRaSH guides to your Sonarr/Radarr instances.

Features

Recyclarr supports Radarr and Sonarr (Sonarr v4 or newer). The following information can be synced to these services from the TRaSH Guides. For a more detailed features list, see the Features page.

  • Quality Profiles, including qualities and quality groups
  • Custom Formats, individually or as groups, including scores (from guide or manual)
  • Quality Definitions (file sizes)
  • Media Naming Formats
  • Media Management (Propers/Repacks)

Getting Started

New to Recyclarr? The Getting Started guide walks through installing it with Docker and syncing your first TRaSH Guides quality profile from a ready-made template.

[!WARNING] The latest Docker tag is not available on Docker Hub or GHCR. Use a major version tag (e.g. 8) instead. See the Docker tags docs.

Read the Documentation

view - Documentation

Main documentation is located at recyclarr.dev. Links provided below for some main topics.

Getting Support

For help with using Recyclarr, please join the TRaSH-Guides Discord and ask in the #recyclarr channel. Read Getting Help first for the details to include with your question.

[!IMPORTANT] The GitHub Issues section is reserved for:

  • Bug reports
  • Feature requests

Please do not use GitHub Issues for general support questions or configuration help. Report security vulnerabilities privately as described in the Security Policy.

Contributing

Contributions are welcome. Non-trivial changes need an approved design in an issue before a pull request is opened. See CONTRIBUTING.md for the workflow, standards, and development setup.

Sponsors

Thank you to all who have supported Recyclarr!

User avatar: Michiel van Baak JansenUser avatar: Liam TiemonUser avatar: yammes08User avatar: FabricioUser avatar: jporto24User avatar: daithi-coyleUser avatar: Steven KreitzerUser avatar: BaukeUser avatar: Kit HamUser avatar: Rok ŠvikartUser avatar: Nikita PedorichUser avatar: Berzan

Powered By

Jetbrains Rider

Download Statistics

5,444,752
Total Downloads
615,600
This Month
365,220
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
ghcr.io/recyclarr/recyclarr:8
Last Updated2026-10-07
First Seen2022-06-02

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--user="99:100"

Template configuration

AppData Config PathPathrw

This is the application data directory for Recyclarr. In this directory, files like recyclarr.yml and settings.yml exist, as well as logs, cache, and other directories.

Target
/config
CRON_SCHEDULEVariable

Standard cron syntax for how often you want Recyclarr to run. See: https://github.com/recyclarr/recyclarr/wiki/Docker#cron-mode

Default
@daily
Value
@daily
RECYCLARR_CREATE_CONFIGVariable

Starting with version 3.0.0, whether the container should create a default recyclarr.yml on start-up if it does not exist. Valid values: 'false' (default) or 'true'.

Default
false
Value
false