Compose-Examples/examples/arr-suite/README.md

181 lines
10 KiB
Markdown
Raw Normal View History

2024-02-28 00:39:07 +00:00
# References
- https://docs.linuxserver.io/images/docker-prowlarr/
- https://docs.linuxserver.io/images/docker-sonarr/
- https://docs.linuxserver.io/images/docker-radarr/
2024-02-28 10:18:59 +00:00
- https://docs.linuxserver.io/images/docker-lidarr/
2024-02-28 19:36:46 +00:00
- https://docs.linuxserver.io/images/docker-readarr/
2024-11-17 14:41:44 +00:00
- https://docs.linuxserver.io/images/docker-bazarr/
2024-02-28 20:36:57 +00:00
- https://github.com/FlareSolverr/FlareSolverr
2024-02-28 00:39:07 +00:00
- https://docs.linuxserver.io/images/docker-qbittorrent/
2024-03-16 00:48:34 +00:00
- https://hub.docker.com/r/qmcgaw/gluetun
2024-02-28 00:39:07 +00:00
- https://docs.linuxserver.io/images/docker-emby/
2024-03-13 20:10:34 +00:00
- https://docs.linuxserver.io/images/docker-jellyfin (alternative option to emby)
2024-02-28 00:39:07 +00:00
# Notes
> [!WARNING]
> Downloading copyright restricted movies or media in general is illegal in most countries.
>
> Use this docker stack responsibly!
2024-03-16 01:01:57 +00:00
> [!CAUTION]
> This setup makes use of gluetun to obtain a vpn killswitch network. This requires a vpn provider like mullvad or others.
2024-02-28 00:39:07 +00:00
Docker stack consisting of various arr-services like:
- Prowlarr
2024-02-28 09:54:20 +00:00
- Used as indexer for torrent links
2024-02-28 00:39:07 +00:00
- Sonarr
2024-02-28 09:54:20 +00:00
- Used for tv shows
2024-02-28 00:39:07 +00:00
- Radarr
2024-02-28 09:54:20 +00:00
- Used for movies
2024-02-28 10:18:59 +00:00
- Lidarr
2024-02-28 19:36:46 +00:00
- Used for music
- Readarr
2024-02-28 20:14:26 +00:00
- Used for books
2024-11-17 14:38:51 +00:00
- Bazarr
- Used for subtitles
2024-02-28 20:39:17 +00:00
- Flaresolverr
2024-02-28 20:42:48 +00:00
- Used to bypass Cloudflare for prowlarr
- You must add it at prowlarr as indexer with the tag `flaresolverr`
2024-02-28 00:39:07 +00:00
- Qbittorrent
2024-03-16 00:48:34 +00:00
- Used as download client; run behind gluetun vpn killswitch container
2024-02-28 09:54:20 +00:00
- A temporary password for the `admin` user will be printed to the container log on startup. Change it immediately to a static one that does not change again.
2024-03-16 00:48:34 +00:00
- Gluetun
- Used for establishing an openvpn/wireguard killswitch vpn connection for qbittorrent
2024-03-16 01:01:57 +00:00
- Requires an active subscription for a vpn provider (e.g. Mullvad)
2024-03-13 20:10:34 +00:00
- Emby / Jellyfin
2024-02-28 09:54:20 +00:00
- Used to manage your media libraries and stream it from various devices
2024-02-28 00:39:07 +00:00
The following bind mount volumes are defined:
- `/arr-suite/configs/<container-name>`
- holds the config files of an arr container
2024-02-29 00:52:37 +00:00
- `/arr-suite/media/`
- will hold your media files such as movies, music, books, tv-shows, qbittorrent downloads etc.
2024-02-28 00:39:07 +00:00
2024-02-28 01:07:11 +00:00
## Setup
2024-11-17 14:47:53 +00:00
You can follow parts of [this Youtube tutorial](https://youtu.be/LD8-Qr3B2-o?si=49RQxJ5KRcoETCiQ&t=740) on how to configure most of the arr applications.
2024-02-28 01:07:11 +00:00
2024-11-17 21:04:42 +00:00
> **Note**: As all arr containers live within the same Docker network, you can easily reference container names instead of IPs. Docker will resolve the container names automatically to the current docker containers' IP. No need for port mappings or defining your Docker server's IP address. Use Docker networks! The only exception is qbittorrent, which uses the vpn killswitch network of the gluetun container. Here, the gluetun container will expose qbittorrent's web ui on TCP/8080 and the IP address of your docker host server. Setup qbittorrent in all arr-applications using your server's local IP address, on which port 8080 is mapped to.
2024-02-28 01:07:11 +00:00
2024-11-17 20:39:33 +00:00
Please make sure to configure authentication for all arr containers. Authentication is often optional and not enabled per default.
2024-11-17 20:39:33 +00:00
### Gluetun
Please refer to the official wiki of Gluetun to configure it for your commercial VPN provider in use.
For this compose example, we will use Mullvad VPN, which is a privacy-friendly VPN provider that does not log. If you use another VPN provider, you have to adjust the environment variables typically.
https://github.com/qdm12/gluetun-wiki
### Prowlarr
2024-11-17 20:54:19 +00:00
#### API Connection to other Arrs
2024-11-17 20:39:33 +00:00
After spawning up the compose stack, Prowlarr will be accessible on `http://<YOUR-IP>:9696`.
Within Prowlarr, we have to configure API connectivity to Sonarr, Lidarr, Readarr and any other arrs. To do so, just log into Prowlarr via the HTTP UI and access `Settings > Apps` under `/settings/applications`. Hit the plus button and add your arr application.
To add an arr application, you typically have to create an API key first. To do so, log into the other arr applications via the UI and create an API key. You can find the application area for this typically at `Settings > General > API Key` under `/settings/general`.
Just make sure that the URL is correct and paste the API key. Should look something like this:
2024-02-28 01:07:11 +00:00
![image](https://github.com/Haxxnet/Compose-Examples/assets/21357789/8915f9f3-081f-41d2-9c5e-bdf9553e09c2)
![image](https://github.com/Haxxnet/Compose-Examples/assets/21357789/94de5802-3b26-420b-bb1d-ac82cd5a5cfb)
2024-11-17 21:04:42 +00:00
> **Note**: As all arr containers live within the same Docker network, you can easily reference container names instead of IPs. Docker will resolve the container names automatically to the current docker containers' IP. No need for port mappings or defining your Docker server's IP address.
2024-11-17 20:39:33 +00:00
2024-11-18 00:19:48 +00:00
#### FlareResolverr CloudFlare Bypass
2024-11-17 20:54:19 +00:00
2024-11-18 00:19:48 +00:00
Moreover, we will add FlareResolverr to Prowlarr in order to bypass CloudFlare for some indexers. To do so, head over to `Settings > Indexer` under `/settings/indexers`. Hit the plus button and add FlareResolverr. Ensure to define the correct URL and also the tag `flaresolverr`.
2024-11-17 20:39:33 +00:00
![image](https://github.com/Haxxnet/Compose-Examples/assets/21357789/19a26a74-dae0-4381-9614-46d20f912542)
2024-11-17 20:54:19 +00:00
#### Qbittorrent Download Client
Finally, add Qbittorrent as download client to Prowlarr. Head over to `Settings > Download Clients` and add a new one.
Define your server's IP address at `Host` (or the container name `arr-suite-gluetun`) and `8080` at `Port`.
2024-11-17 20:57:07 +00:00
![image](https://github.com/user-attachments/assets/a21d117c-7ebf-4e01-a14e-11b8e3e59600)
2024-11-17 20:39:33 +00:00
### Qbittorrent
2024-11-17 20:40:29 +00:00
> [!WARNING]
2024-11-17 20:39:33 +00:00
> Qbittorrent is run behind the Gluetun VPN killswitch container. Therefore, we have to port map the Qbittorrent port 8080 at the gluetun container.
2024-11-18 00:19:48 +00:00
>
> This is also the reason why we define `arr-suite-gluetun` as host when adding Qbittorent and its port 8080 as download client to other arr containers.
2024-11-17 20:39:33 +00:00
2024-11-18 00:19:48 +00:00
Log into the Qbittorrent's web UI. The UI is typically accessible from `http://<YOUR-IP>:8080`.
2024-11-17 20:39:33 +00:00
2024-11-18 00:19:48 +00:00
The default username is `admin`. Make sure to change the password immediately. The initial password is printed in the container logs. If you do not change the password immediately, a new password will be printed and set upon each container restart.
2024-11-17 20:39:33 +00:00
Then head over to `Settings > Downloads` and configure the custom download path `/media/downloads` as follows:
![image](https://github.com/Haxxnet/Compose-Examples/assets/21357789/278b800d-2b6b-45cb-a44c-7f56def7f9d3)
> [!TIP]
2024-11-17 21:11:31 +00:00
> If you would like to ensure that Qbittorrent downloads stuff via the gluetun VPN killswitch and not your personal WAN IP, you may use [this GitHub project](https://github.com/AKK9/torrent-ip-checker). It is an example torrent file, which does not actually download something malicious but reports back your disclosed IP address. The reported IP address must be the one from your commercial VPN provider like Mullvad.
>
> Just [download the torrent file](https://vvdapo30eb.execute-api.eu-west-2.amazonaws.com/torrent) and upload it via Qbittorrent's web UI via `File > Add torrent file`.
2024-11-17 20:39:33 +00:00
2024-11-17 21:09:23 +00:00
![image](https://github.com/user-attachments/assets/5c7531eb-2cd7-4b16-968d-32a00cc4020a)
2024-11-17 20:39:33 +00:00
### Sonarr, Radarr, Lidarr, Readarr, Bazarr
All other arr applications follow the same configuration steps.
2024-11-17 21:06:21 +00:00
Follow these steps for each individuall arr container:
2024-11-17 20:39:33 +00:00
1. Configure authentication for the arr's HTTP UI. Can be done regularly via `Settings > General`.
2024-11-17 21:01:02 +00:00
2. Ensure to define your media location. Can be done regularly via `Settings > Media Management > Root Folders > Path`. Should point to `/media/music` for Lidarr, `/media/tv-shows` for Sonarr, `/media/movies` for Radarr and `/media/books` for Readarr and so on.
2024-11-17 20:51:24 +00:00
3. Configure Qbittorrent as download client. Can be done regularly via `Settings > Download Clients`. Define your server's IP address at `Host` (or the container name `arr-suite-gluetun`) and `8080` at `Port`.
2024-11-17 21:02:22 +00:00
4. Configure your quality definitions and indexers (optional)
2024-11-17 21:06:21 +00:00
5. Configure Bazarr (Radarr and Sonarr only). See https://wiki.bazarr.media/Getting-Started/Setup-Guide/
2024-11-17 21:02:22 +00:00
6. Fix all `System > Health` warnings and errors reported by each arr container. May refer to https://wiki.servarr.com/.
2024-11-17 20:39:33 +00:00
- Sonarr is accessible at `http://<YOUR-IP>:8989/`
- Radarr is accessible at `http://<YOUR-IP>:7979/`
- Lidarr is accessible at `http://<YOUR-IP>:8686/`
- Bazarr is accessible at `http://<YOUR-IP>:6767/`
- Readarr is accessible at `http://<YOUR-IP>:8787/`
### Emby / Jellyfin
2024-11-18 00:19:48 +00:00
The Docker Compose stack makes use of Emby as default. You can switch to Jellyfin though by removing the Emby container service and uncommenting the Jellyfin one.
2024-11-17 21:00:04 +00:00
2024-11-18 00:19:48 +00:00
- Emby or Jellyfin will be accessible at `http://<YOUR-IP>:8096/`
2024-11-17 21:00:04 +00:00
Follow the below steps to configure one of these media streaming containers:
2024-11-17 20:39:33 +00:00
1. Configure authentication for your media streaming app. Can be done natively via the HTTP UI settings.
2. Ensure to define your media location for your library. Can be done natively via the HTTP UI settings.
2024-11-17 20:51:24 +00:00
3. Configure transcoding and passthrough your GPU into the container (optional)
2024-11-17 20:39:33 +00:00
### Reverse Proxy
2024-11-18 00:19:48 +00:00
It is recommended to run all containers with an HTTP UI behind a reverse proxy. The reverse proxy can enforce a TLS encrypted communication channel with valid SSL certificates. Also add access controls via IP whitelisting, IdP forward-auth and many more.
2024-11-17 20:39:33 +00:00
2024-11-18 00:19:48 +00:00
This example Compose Stack includes labels for the Traefik reverse proxy. Uncomment those to make use of it. Otherwise, remove them.
2024-11-17 20:39:33 +00:00
2024-11-18 00:19:48 +00:00
If you run a different reverse proxy, please refer to the official documentation on how to configure proxy hosts. The ports to proxy on are defined in the Docker Compose file using the `expose` directive.
2024-11-17 20:39:33 +00:00
> [!TIP]
2024-11-18 00:19:48 +00:00
> Once a reverse proxy is in use, you can typically remove all port mappings from the Docker Compose file. The reverse proxy will do the proxying and must be placed in the same Docker bridge network as the arr media stack.
2024-11-17 20:39:33 +00:00
>
2024-11-18 00:19:48 +00:00
> Note that the Qbittorrent TCP/8080 port is mapped at the Gluetun VPN killswitch container. So your reverse proxy must proxy to the 8080 port mapped on your docker server's IP address in order to access the Qbittorrent admin UI.
2024-11-17 20:39:33 +00:00
#### Traefik + Emby + HTTP Headers
2024-02-28 01:07:11 +00:00
2024-02-28 13:30:35 +00:00
During the setup of Emby in a web browser (HTTPS via Traefik) you may notice errors in the developer console, which prevent the web page from loading properly.
Those errors occur, if you have configured secure HTTP response headers such as X-Content-Type-Options with the directive "nosniff".
To complete the web-based setup, you either have to temporarely disable the HTTP header or browse the Emby instance without Traefik as reverse proxy.
After the setup was completed, the errors are gone and you can use Emby regularly with Traefik, HTTPS and any X-Content-Type-Options header configuration.