Lidarr¶

Lidarr is an RSS Downloader focused on music, it'll help automate music downloads.

Requirements¶

Before installing Lidarr, we'll need to install Mono which is a C# Runtime for Linux. Run the following commands to install Mono:

sudo apt-get install gnupg ca-certificates
sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
echo "deb https://download.mono-project.com/repo/ubuntu stable-bionic main" | sudo tee /etc/apt/sources.list.d/mono-official-stable.list
sudo apt-get update
sudo apt-get install mono-devel

Installation¶

The Lidarr installation is reduced to the following commands:

curl -L -O $( curl -s https://api.github.com/repos/lidarr/Lidarr/releases | grep linux.tar.gz | grep browser_download_url | head -1 | cut -d \" -f 4 )
tar -xvzf Lidarr.master.*.linux.tar.gz
sudo mv Lidarr /opt

And finally, we'll create a lidarr user and group to manage Lidarr:

sudo addgroup lidarr && sudo adduser --system lidarr --ingroup lidarr
sudo chown lidarr:lidarr -R /opt/Lidarr

Starting Lidarr¶

To start Lidarr, run the following command:

mono --debug /opt/Lidarr/Lidarr.exe

The web service should be available at http://localhost:8686.

Autostarting Lidarr¶

To autostart Lidarr, we need to create a service file.

sudo nano /etc/systemd/system/lidarr.service

And paste the following in the editor:

[Unit]
Description=Lidarr Daemon
After=network.target

[Service]
User=lidarr
Group=lidarr
ExecStart=/usr/bin/mono --debug /opt/Lidarr/Lidarr.exe -nobrowser
TimeoutStopSec=20
KillMode=process
Restart=on-failure

[Install]
WantedBy=multi-user.target

Exit, save and enable and start the service.

sudo systemctl enable lidarr.service
sudo systemctl start lidarr.service

Using a Server Name to Access Lidarr¶

If you wish to access Lidarr through a specific domain, you will need to use some sort of reverse proxy. From the previous sections, where we installed Gitea, we created a domain that would be used to accessed Gitea. In this case, we we'll create a media subdomain on our domain to access Lidarr through https://media.domain.com/lidarr.

Installing nginx¶

If you haven't installed nginx, run:

sudo apt-get install nginx

Configuring Virtual Host¶

We'll now create a virtual host file:

sudo nano /etc/nginx/sites-enabled/media

And we'll paste the following:

server {
    listen 80;
    server_name <your-domain>;

    location /lidarr {
        proxy_pass http://localhost:8686;
    }

    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}

If there's still a default configuration, you'll need to remove it:

sudo rm /etc/nginx/sites-enabled/default

And finally, we'll restart nginx.

sudo systemctl restart nginx.service

After setting-up the reverse proxy, we must also set the base URL for Lidarr to work properly. Run the following command:

sudo nano /home/lidarr/.config/Lidarr/config.xml

And inside, look for the line:

<UrlBase></UrlBase>

And change it to:

<UrlBase>/lidarr</UrlBase>

HTTPS Certificate¶

If you have certbot installed and configured already, you can enable HTTPS for Lidarr with the following command:

sudo certbot --nginx

If you haven't enabled certbot or configured it yet, check out this part of the guide: Enabling HTTPS for Gitea.