# Radarr •

[Radarr](https://radarr.video/) is a free and open-source media management tool that can automatically download, organize and manage your movie collection. Organize your existing collection, add new movies from the [TMDb](https://www.themoviedb.org/) or import lists to keep up-to-date. Always be sure that your media has the correct metadata for your [Plex](https://hub.subspace.services/books/plex "Plex") or [Jellyfin](https://hub.subspace.services/books/jellyfin "Jellyfin") media server.

# Overview

[![Screen Shot 2025-03-06 at 22.20.53.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-20-53.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-20-53.png)

[Radarr](https://radarr.video/) is a free and open-source media management tool that can automatically download, organize and manage your movie collection. Organize your existing collection, add new movies from the [TMDb](https://www.themoviedb.org/) or import lists to keep up-to-date. Always be sure that your media has the correct metadata for your [Plex](https://hub.subspace.services/books/plex "Plex") or [Jellyfin](https://hub.subspace.services/books/jellyfin "Jellyfin") media server.

- Connects to [Prowlarr](https://hub.subspace.services/books/prowlarr "Prowlarr") to aggregate Usenet and Torrent queries to multiple sources into one unified search result.
- View all of your upcoming movies on a calendar and export it for your calendar app.
- Perform automatic searches to find media within your specifications, or manually search through the results.
- Blacklist any failed downloads and Radarr will search for a different download.
- Add a single movie to your library, or make sure you have every one from that collection or movie series.

# Media

## Screenshots

<p class="callout info">Radarr v5.19.3.9730</p>

<table border="1" id="bkmrk-" style="border-collapse: collapse; width: 100%; height: 332.9px; border: 1px solid rgb(88, 110, 117);"><colgroup><col style="width: 33.2927%;"></col><col style="width: 33.2927%;"></col><col style="width: 33.2927%;"></col></colgroup><tbody><tr style="height: 166.45px;"><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.20.53.png](https://hub.subspace.services/uploads/images/gallery/2025-03/bWcscreen-shot-2025-03-06-at-22-20-53.png)](https://hub.subspace.services/uploads/images/gallery/2025-02/1000006357.png)</td><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.21.00.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-21-00.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-21-00.png)</td><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.21.14.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-21-14.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-21-14.png)</td></tr><tr style="height: 166.45px;"><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.21.31.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-21-31.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-21-31.png)</td><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.22.06.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-22-06.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-22-06.png)</td><td style="height: 166.45px; border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.22.26.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-22-26.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-22-26.png)</td></tr><tr><td style="border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.26.18.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-26-18.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-26-18.png)</td><td style="border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.36.19.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-36-19.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-36-19.png)</td><td style="border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-06 at 22.36.29.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-06-at-22-36-29.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-06-at-22-36-29.png)</td></tr><tr><td style="border-color: rgb(88, 110, 117);">[![Screen Shot 2025-03-07 at 00.12.38.png](https://hub.subspace.services/uploads/images/gallery/2025-03/scaled-1680-/screen-shot-2025-03-07-at-00-12-38.png)](https://hub.subspace.services/uploads/images/gallery/2025-03/screen-shot-2025-03-07-at-00-12-38.png)</td><td style="border-color: rgb(88, 110, 117);">  
</td><td style="border-color: rgb(88, 110, 117);">  
</td></tr></tbody></table>

# Setup & Configuration

We need to install the service through Portainer and configure any necessary settings.

# Preparation

There are some things we need to do in preparation to install this service.

## Volumes

<details id="bkmrk-media-folders-radarr"><summary>Persistent Data</summary>

This is where the service will store its own application data and ensures we can quickly update the service image.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-media-folders-radarr-1"><summary>Media Folders</summary>

Radarr will need access to the folders where you store your movie files.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details><details id="bkmrk-download-folder-rada"><summary>Download Folders</summary>

Radarr will need access to the folder where you torrent or usenet folder store their completed downloads.

<p class="callout warning">Ensure your user has permissions to access the folder.</p>

</details>## Environment

<details id="bkmrk-tz-this-is-the-curre"><summary>TZ</summary>

This is the current time zone formatted using the [tz database.](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)

<p class="callout info">*For example:* America/Vancouver</p>

</details><details id="bkmrk-gid-%C2%A0"><summary>PUID</summary>

This is the numeric ID of the user account on Debian. If you are unsure, open a terminal and run:

```bash
id -u
```

</details><details id="bkmrk-pgid-this-is-the-num"><summary>PGID</summary>

This is the numeric ID of the user account's group on Debian. If you are unsure, open a terminal and run:

```bash
id -g
```

</details>

# Installation

The service can be installed through the Portainer web interface.

<p class="callout info">Learn about [creating a new stack](https://hub.subspace.services/books/portainer/page/creating-a-new-stack "Creating a New Stack").</p>

## Docker Compose

Use the following code to install the service:

```yaml
---
services:
  radarr:
    image: lscr.io/linuxserver/radarr:latest
    container_name: radarr
    network_mode: bridge
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/Vancouver
    volumes:
      # Persistent Data
      - /srv/radarr:/config

      # Media Folders
      - /mnt/movies:/mmt/movies

      # Downloads Folder
      - /mnt/downloads:/mnt/downloads
    ports:
      - 7878:7878
    restart: unless-stopped
```

# Updating

<p class="callout success">Re-Deploy the Stack</p>

This service has been optimized for running in Docker thanks to [LinuxServer.io](https://linuxserver.io).

This allows you to [re-deploy the stack through Portainer](https://hub.subspace.services/books/portainer/page/updating-a-stack "Updating a Stack") to download the latest updates.

# User Manual

# Development

<p class="callout info">This software is released under the [GPL-3.0 license](https://opensource.org/license/gpl-3-0).</p>

The software was developed as a fork of [Sonarr](https://hub.subspace.services/books/sonarr "Sonarr"). Radarr is made available for Docker through the efforts of [LinuxServer.io](https://docs.linuxserver.io/images/docker-radarr/) and their commitment to simplifying self-hosting.

You can learn more about how to contribute to Radarr through their [documentation](https://wiki.servarr.com/radarr/contributing).

The Radarr development team also accepts [donations](https://radarr.video/donate).

# Resources

## Official

- [Official Wiki](https://wiki.servarr.com/radarr)
- [Official Discord](https://radarr.video/discord)
- [Official GitHub Repository](https://github.com/Radarr/Radarr)
- [Official Website](https://radarr.video/)
- [Installation Guide](https://wiki.servarr.com/radarr/installation)
- [Quick Start Guide](https://wiki.servarr.com/radarr/quick-start-guide)
- [Frequently Asked Questions](https://wiki.servarr.com/radarr/faq)
- [General Troubleshooting](https://wiki.servarr.com/radarr/troubleshooting)

## LinuxServer.io

- [Docker Image](https://docs.linuxserver.io/images/docker-radarr/)
- <div>[Official Website](https://www.linuxserver.io/)</div>
- <div>[Official Documentation](https://docs.linuxserver.io/)</div>
- <div>[Official Discord](https://linuxserver.io/discord)</div>
- <div>[Official Forum](https://discourse.linuxserver.io/)</div>
- <div>[Official GitLab Repository ](https://gitlab.com/Linuxserver.io)</div>
- <div>[Frequently Asked Questions](https://docs.linuxserver.io/FAQ/)</div>