====== Systems - Docker Main - Install Docker Containers - Install Sonarr ======

Sonarr automates TV downloads from public and private trackers.

----

===== Create the Sonarr Directories =====

Sonarr will store its configuration data in a directory on the Host VM.

On the Ubuntu VM Host, create a directory for this config data.

<code bash>
mkdir /home/peter/sonarr
mkdir /home/peter/sonarr/config
mkdir /home/peter/sonarr/tv
mkdir /home/peter/downloads
</code>

<WRAP info>
**NOTE:** The **downloads** directory will be used by other services too, so not within the **sonarr** directory.
</WRAP>


----

===== Determine the UID and GID =====

On the Ubuntu VM Host:

<code bash>
id peter
</code>

returns:

<code bash>
uid=1000(peter) gid=1000(peter) groups=1000(peter)...
</code>

<WRAP info>
**NOTE:**  Take a note of the UID and GID numbers.

  * In this case 1000.
</WRAP>

----

===== Install Sonarr =====

In Portainer:

  * Select **Stack**.
  * Click **Add Stack**.
  * Name:  **Sonarr**.
  * Web editor: <file bash docker-compose>
---
version: "2.1"
services:
  sonarr:
    image: ghcr.io/linuxserver/sonarr
    container_name: sonarr
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Europe/Jersey
    volumes:
      - /home/peter/sonarr/config:/config
      - /home/peter/sonarr/tv:/tv #optional
      - /home/peter/downloads:/downloads #optional
    ports:
      - 8989:8989
    restart: unless-stopped
</file>

<WRAP info>
**NOTE:**  Change settings as required.

  * **/home/peter/sonarr/config**:  This directory will need to be created on the host.
  * **/home/peter/sonarr/tv**:  This directory contains the TV shows.
  * **PUID** and **GUID**:  Set to the numbers determined earlier.
  * Port **8989**:  Change as required.
</WRAP>

----

===== Confirm Sonarr is running =====

Open Portainer.

Press **F5** to refresh.

<WRAP info>
**NOTE:** This should show the Sonarr container running.
</WRAP>

----

===== Open Sonarr =====

Visit http://192.168.1.30:8989 in a browser.

<WRAP info>
**NOTE:**  The IP address is whatever the Ubuntu VM is using.

  * The **8989** port is the port configured for Sonarr.

  * It is suggested to set this URL in the web browser to be the default loading page.

</WRAP>

----

===== Setup Sonarr =====

Configure as required.

For example, change file naming:

<code>
{Series Title} - S{season:00}E{episode:00} - {Episode Title} {Quality Full}

to

{Series Title}.S{season:00}E{episode:00}.{Episode Title}.{MediaInfo VideoCodec}.{Quality Title}
</code>

----

===== References =====

https://hub.docker.com/r/linuxserver/sonarr

https://fleet.linuxserver.io/image?name=linuxserver/sonarr