SSD Nodes Learn Hosting plans →
Mga Gabay Matt ConnorNi Matt Connor

Docker Compose arr stack: Prowlarr, Sonarr at Radarr

Patakbuhin ang Prowlarr, Sonarr, Radarr at qBittorrent sa isang Docker Compose file, gamit ang iisang PUID, PGID at volume layout para gumana ang hardlinks.

Ang itinatayo mo

Ang Docker Compose arr stack ay binubuo ng apat na container na namamahala sa isang media library: Prowlarr para sa mga setting ng indexer, Sonarr para sa mga series, Radarr para sa mga pelikula, at qBittorrent bilang download client. Nag-uusap ang mga ito sa Compose network gamit ang service name, at nagbabahagi ng iisang folder tree sa host. Maikli ang installation. Ang volume layout ang pangunahing nagtatakda kung gagana nang maayos ang stack sa loob ng maraming taon o magdudulot ng paulit-ulit na problema bawat linggo, kaya malaking bahagi ng guide na ito ang nakatuon dito.

Hindi awtomatikong naghahanap ng content ang stack para sa iyo. Ang Prowlarr ang naglalaman ng anumang indexer na idaragdag mo rito, at ikaw ang nagpapasya kung aling mga indexer ang gagamitin at ikaw rin ang may legal na pananagutan dito. Nakatuon ang guide na ito sa plumbing: mga user, path, permission, container networking, at mga check na nagpapatunay na gumagana ito.

Kung hindi ka pa nakakasulat ng Compose file, basahin muna ang mga pangunahing kaalaman sa Docker Compose para sa isang VPS. Ipinapalagay ng post na ito na docker compose version ay may inilalabas nang output sa server mo. Gamitin ang Docker Engine 28.0.0 o mas bago: pinapayagan ng mas lumang release na maabot ng mga host sa parehong local network segment ang mga port na naka-publish sa localhost.

Kapag tapos nang mag-download ang Sonarr, ini-import nito ang file sa iyong library. Kung nasa iisang filesystem ang download folder at library folder at naka-enable ang hardlinking, susubukan ng Sonarr na gumawa ng hardlink: pangalawang pangalan na tumutukoy sa parehong data sa disk. Wala itong dagdag na space o oras. Patuloy na nagse-seed ang torrent mula sa dating pangalan, habang binabasa ng media server ang bago.

Kung magkaiba ang filesystem ng dalawang folder, hindi magagawa ng kernel ang link na iyon. Magfa-fallback ang Sonarr sa pagkopya. Ang isang 40 GB na season ay mangangailangan na ngayon ng 80 GB na disk space at ilang minuto ng input at output. Nila-log ng Sonarr ang mga cross-filesystem hardlink failure sa Trace level at ang iba pang hardlink exception sa Debug level, kaya hindi garantiya ang ordinaryong logs na may makikitang failure message. Sa VPS na may fixed disk allowance, ganito nauubusan ng space ang mga tao sa loob ng isang linggo.

Ito ang karaniwang problema. Sa loob ng container, ang bind mount ay isang filesystem boundary. I-mount ang /mnt/data/torrents bilang /downloads at ang /mnt/data/media bilang /tv, at kahit nasa iisang host disk ang mga ito, makikita ng Sonarr ang dalawang magkahiwalay na mount at hindi ito makakagawa ng hardlink sa pagitan ng mga ito. Direktang sinasabi ito sa opisyal na documentation ng LinuxServer.io image: kapag hiwalay na /downloads at /tv paths ang ginamit, mawawala ang kakayahang gumawa ng hardlink.

Ang solusyon ay isang mount lamang. Ang bawat container na gumagamit ng media ay dapat makakuha ng parehong iisang volume, /mnt/data:/data, at bawat path na ginagamit nito ay dapat folder sa loob ng volume na iyon. Isang mount point, isang filesystem, at gumaganang hardlinks.

Gawin ang user, group, at mga folder

Nagsusulat ang mga container ng mga file gamit ang numeric user ID na itinatakda ng PUID at PGID. Gamitin ang sarili mong account para mabasa at ma-edit mo ang mga file na iyon sa SSH nang hindi gumagamit ng sudo.

id -u
id -g

Karaniwan, parehong nagpi-print ang mga ito ng 1000 sa bagong Ubuntu VPS. Ngayon, gawin ang directory tree. Ilagay ito sa disk na naglalaman ng iyong media, at panatilihin ang buong tree sa disk na iyon.

sudo mkdir -p /mnt/data/torrents/movies /mnt/data/torrents/tv
sudo mkdir -p /mnt/data/media/Movies /mnt/data/media/Shows
sudo chown -R 1000:1000 /mnt/data
sudo chmod -R 775 /mnt/data

Tiyaking iisang filesystem talaga ito bago magpatuloy:

df --output=source,target /mnt/data/torrents /mnt/data/media

Dapat magpakita ang dalawang linya ng parehong source device. Kung magkaiba ang device, hindi kailanman gagana ang hardlinks, anuman ang itakda mo sa container config.

Sadyang pinangalanang Movies at Shows ang mga library folder. Kung gumagamit ka na ng Jellyfin bilang media server, i-mount ang /mnt/data/media sa Jellyfin bilang /media, at mapupunta ang mga library nito sa /media/Movies at /media/Shows, eksaktong gaya ng inilagay ng gabay na iyon.

Ang environment file

Panatilihin sa .env ang mga value na nagbabago depende sa server, katabi ng Compose file.

mkdir -p ~/arr && cd ~/arr

Isulat ang ~/arr/.env:

PUID=1000
PGID=1000
TZ=Etc/UTC
DATA_ROOT=/mnt/data

Itakda ang TZ sa sarili mong zone, gaya ng Europe/Berlin. Ginagamit ng arr applications ang zone na iyon sa pag-schedule ng mga task at paglalagay ng timestamp sa mga log line, kaya magiging nakalilito ang lahat ng log kapag mali ang value.

Ang Compose file

Isulat ang ~/arr/docker-compose.yml:

services:
  prowlarr:
    image: lscr.io/linuxserver/prowlarr:latest
    container_name: prowlarr
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
    volumes:
      - ./config/prowlarr:/config
    ports:
      - 127.0.0.1:9696:9696
    restart: unless-stopped

  sonarr:
    image: lscr.io/linuxserver/sonarr:latest
    container_name: sonarr
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
    volumes:
      - ./config/sonarr:/config
      - ${DATA_ROOT}:/data
    ports:
      - 127.0.0.1:8989:8989
    restart: unless-stopped

  radarr:
    image: lscr.io/linuxserver/radarr:latest
    container_name: radarr
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
    volumes:
      - ./config/radarr:/config
      - ${DATA_ROOT}:/data
    ports:
      - 127.0.0.1:7878:7878
    restart: unless-stopped

  qbittorrent:
    image: lscr.io/linuxserver/qbittorrent:latest
    container_name: qbittorrent
    environment:
      - PUID=${PUID}
      - PGID=${PGID}
      - TZ=${TZ}
      - WEBUI_PORT=8080
      - TORRENTING_PORT=6881
    volumes:
      - ./config/qbittorrent:/config
      - ${DATA_ROOT}:/data
    ports:
      - 127.0.0.1:8080:8080
      - 6881:6881
      - 6881:6881/udp
    stop_grace_period: "10s"
    restart: unless-stopped

May apat na bahagi sa file na ito na gumaganap ng mahalagang papel.

Magkapareho ang ${DATA_ROOT}:/data sa tatlong container na nag-a-access sa media. Hindi ito ginagamit ng Prowlarr dahil hindi kailanman nagbubukas ang Prowlarr ng media file.

Naka-bind ang bawat web port sa 127.0.0.1, kaya sa loopback address lamang ito ipinapublish ng Docker. Ang karaniwang 8989:8989 ay magpa-publish nito sa lahat ng interface, at ipapadaan ng sariling firewall rules ng Docker ang traffic nang lampas sa deny rule ng ufw. Madalas itong nakalilito, at ipinaliwanag ito sa kung bakit direktang ipinapasa ng Docker ang mga port lampas sa ufw.

Sinasadyang i-publish ang port 6881 sa lahat ng interface. Ito ang torrent listening port, kaya dapat itong maabot para sa mga incoming peer connection. Pareho rito ang Docker behavior, kaya hindi mo kailangan ng ufw rule para dito, at walang mababago kung magdagdag ka nito. Ayon sa dokumentasyon ng Docker, na sinuri noong November 8, 2026, niruruta ang traffic patungo sa published port bago ito makarating sa mga chain na ginagamit ng ufw, kaya walang epekto ang sudo ufw allow 6881 sa port na ito. Ipinapublish ito ng Docker sa lahat ng host interface kapag nagsimula ang container, at hindi rin ito maisasara ng deny ng ufw. Kung kailangan mong limitahan kung sino ang maaaring kumonekta rito, itinuturo ng dokumentasyon ng Docker ang paggamit ng rules sa DOCKER-USER chain kapag default na iptables backend ang ginagamit; kapag nftables backend naman, kailangan ang rules sa hiwalay na nftables table. Gamitin ang ufw para sa mga serbisyong hindi tumatakbo sa Docker, gaya ng SSH, at basahin ang mga pangunahing kaalaman sa ufw firewall para sa isang VPS kung bago sa iyo ang tool na ito.

Magkahiwalay ang mga config directory ng bawat application, at media volume lamang ang shared. Gawin ang mga directory bago ang unang pagsisimula upang pagmamay-ari ang mga ito ng iyong user sa halip na root:

mkdir -p ~/arr/config/prowlarr ~/arr/config/sonarr ~/arr/config/radarr ~/arr/config/qbittorrent
docker compose up -d
docker compose ps

Dapat basahin ng lahat ng apat na serbisyo ang running. Noong November 8, 2026, naka-publish ang mga image na ito sa lscr.io, at sinusunod ng latest tag ang kasalukuyang stable release. Gumamit ng version tag sa halip kung gusto mong planado ang mga upgrade at hindi ito maging sorpresa.

Ligtas na pag-access sa mga web interface

Naka-bind ang mga web interface sa loopback. I-forward ang mga ito sa SSH mula sa sarili mong machine:

ssh -L 9696:127.0.0.1:9696 -L 8989:127.0.0.1:8989 \
    -L 7878:127.0.0.1:7878 -L 8080:127.0.0.1:8080 you@your-server

Ngayon, kapag binuksan mo ang http://127.0.0.1:8989 sa browser, maa-access mo ang Sonarr sa server. Para sa permanenteng access, ilagay ang stack sa likod ng Traefik na may TLS certificates para sa ilang app, o i-access ang server sa pamamagitan ng WireGuard VPN na ikaw mismo ang nag-host. Hindi awtomatikong naaabot ng VPN ang mga port na ito. Ayon sa documentation ng Docker na sinuri noong November 8, 2026, kapag Docker Engine 28.0.0 o mas bago ang gamit at default bridge configuration ang naka-configure, ang Docker host lamang ang makaka-access sa port na naka-publish sa localhost address. Para magamit ang VPN, patuloy na patakbuhin ang SSH tunnel sa loob nito, o palitan ang bindings sa Compose file mula 127.0.0.1 papunta sa sariling address ng server sa VPN interface. Hindi dapat direktang nasa public internet ang alinman sa mga application na ito na sarili lamang nilang login page ang proteksyon. Kung reverse proxy ang pipiliin mo at mas gusto mong iisang account para sa lahat ng apat na interface kaysa subaybayan ang apat na magkakahiwalay na application login, nagbibigay ang Authentik ng self-hosted single sign-on na maaaring ipatupad ng Traefik sa bawat request gamit ang forward auth. May dalawang espesyal na kailangang ayusin sa Sonarr at Radarr kapag nasa likod sila ng proxy. Bago mo sila i-route sa Traefik, basahin ang paano patakbuhin ang Sonarr at Radarr sa likod ng reverse proxy para sa mga Allowed Hosts entry na pumipigil sa mga Invalid Hostname error at para sa dahilan kung bakit kailangang laktawan ng /api ang login.

Gumagawa ang qBittorrent ng random administrator password sa unang pagsisimula at inililimbag ito sa container log. Basahin ito, pagkatapos ay palitan sa web interface:

docker compose logs qbittorrent | grep -i password

Kung hindi mo ito papalitan, bagong random password ang gagawin sa bawat restart, at kailangan mong bumalik sa logs sa bawat pagkakataon.

Itakda ang mga path sa bawat application

Sa qBittorrent, buksan ang Options, pagkatapos ay Downloads, at itakda ang default save path sa /data/torrents. Panatilihin ang folder para sa incomplete downloads sa loob ng parehong tree, gaya ng /data/torrents/incomplete. Ang download na natapos sa labas ng /data ay hindi maaaring gawing hard link sa library gamit ang Compose file na ito.

Sa Sonarr, buksan ang Settings, pagkatapos ay Media Management, at idagdag ang root folder na /data/media/Shows. Sa Radarr, ang root folder ay /data/media/Movies. Mga path ito sa loob ng container. Hindi tatanggapin ang host path na /mnt/data/media/Shows dahil hindi umiiral ang directory na iyon mula sa pananaw ng container.

Sa Sonarr at Radarr, buksan ang Settings, pagkatapos ay Download Clients, at idagdag ang qBittorrent. Ang host ay qbittorrent at ang port ay 8080. Gumagana ang service name bilang hostname dahil inilalagay ng Compose ang apat na container sa iisang network na may internal DNS (domain name system) service. Huwag gamitin ang localhost dito: sa loob ng Sonarr container, ang localhost ay Sonarr.

Iwanang walang laman ang Remote Path Mappings. Ginagamit ang feature na ito upang isalin ang path na iniuulat ng download client sa path na nakikita ng arr application. Dahil iisa ang shared /data mount, pareho nang ginagamit ng dalawang container ang bawat path. Ito ang ikalawang dahilan kung bakit sulit ang layout na ito.

Ikonekta ang Prowlarr sa Sonarr at Radarr

Ipinapasa ng Prowlarr ang mga definition ng indexer sa ibang application, kaya isang beses mo lang kino-configure ang isang indexer sa halip na dalawang beses. Kailangan nito ng API (application programming interface) key mula sa bawat isa.

Sa Sonarr, buksan ang Settings, pagkatapos ay General, at kopyahin ang API key. Sa Prowlarr, buksan ang Settings, pagkatapos ay Apps, magdagdag ng Sonarr application, at punan ang tatlong field. Ang Prowlarr Server ay http://prowlarr:9696. Ang Sonarr Server ay http://sonarr:8989. Ang API Key ay ang kinopyang value. Pindutin ang Test. Ibig sabihin ng berdeng resulta na naabot ng Prowlarr ang Sonarr sa Compose network. Ulitin ito para sa Radarr sa http://radarr:7878.

Ang pulang resultang nagsasabing tinanggihan ang connection ay nangangahulugang hindi nakarating ang connection sa listening service sa naka-configure na address at port. Tiyaking nagre-resolve ang pangalan mula sa loob ng container:

docker compose exec prowlarr curl -sS -o /dev/null -w '%{http_code}\n' http://sonarr:8989

Pinatutunayan ng HTTP status code na maayos ang network path. Ibig sabihin ng name resolution error na hindi nag-resolve ang service name; suriin ang spelling nito at tiyaking tumatakbo ang parehong container sa iisang Compose network.

Huwag pagkatiwalaan ang setup hangga't hindi mo nakikita ang link count. Pagkatapos ma-import ang isang item, paghambingin ang na-download na file at ang file sa library:

stat -c '%i %h %n' /mnt/data/torrents/tv/*/*.mkv
stat -c '%i %h %n' /mnt/data/media/Shows/*/*/*.mkv

Ang unang numero ay ang inode, at ang pangalawa ay ang link count. Sa iisang filesystem, ang dalawang file na hardlink sa isa't isa ay may parehong inode at link count na hindi bababa sa 2; nadaragdagan ang count na ito kapag may karagdagang hardlink. Ibig sabihin ng magkaibang inode na hindi hardlink sa isa't isa ang mga file, pero hindi nito pinatutunayang nabigo ang pagtatangkang gumawa ng hardlink. Kumokopya rin ang Sonarr nang hindi nagtatangkang gumawa ng hardlink kapag naka-disable ang hardlink setting nito. Nila-log ang mga pagkabigo ng hardlink sa magkakaibang filesystem sa antas na Trace, at ang iba pang hardlink exception sa antas na Debug, kaya hindi garantiya ang karaniwang import logs na may makikitang paliwanag.

Subaybayan din ang disk. Halos hindi dapat gumalaw ang df -h /mnt/data kapag may import, dahil nagdaragdag lamang ng pangalan ang hardlink at hindi ng data.

Ano talaga ang nasisira

Ang mga permission error kapag nag-i-import ay nangangahulugang hindi makapagsulat ang user id ng container sa library folder. Ang mensahe ay Access to the path ... is denied. Gamitin ang ls -ln /mnt/data/media upang tiyaking tumutugma ang owner id sa iyong PUID, at tandaan na kailangan ng mga directory ang execute bit bago mapasok ng container ang mga ito.

Maaaring maging root-owned ang mga directory kapag sinimulan ang container bago umiral ang directory sa host, dahil gumagawa ang Docker ng mga nawawalang bind-mount directory. Ihinto ang stack, chown ang directory, at simulan itong muli.

Kapag nag-delete ka ng torrent sa qBittorrent at nakita mong nawala ang file sa library, kailangang suriin kung aling mga path ang na-delete. Ang pag-delete lamang ng download ay hindi nag-aalis ng hiwalay na kopya o hardlink sa library. Kapag tunay na hardlink ito, mananatili ang ibang pangalan kapag inalis ang isa, dahil mababawi lamang ang data kapag umabot sa zero ang link count.

Ang disk na mas mabilis mapuno kaysa sa dami ng media na idinagdag mo ay ang pinakamagastos na anyo ng problema sa pagkopya. Patakbuhin muna ang stat check sa itaas bago bumili ng karagdagang storage.

Mga kailangan ng stack na ito mula sa isang VPS

Magaan ang tatlong arr application. Nagpo-poll ang mga ito sa indexer, nagsusulat sa maliit na SQLite database, at nagre-rename ng mga file. Sa ibang bahagi nanggagaling ang load. Maaaring lubusang gamitin ng download client ang disk input at output kapag malalaki ang torrent, at gagamitin ng media server na nagta-transcode ng video sa parehong box ang CPU. Ilagay ang media sa volume na may aktuwal na throughput, at magtakda ng bandwidth limit sa download client kung may iba pang mahalagang gawain ang server. Maglaan ng hiwalay na budget para sa iba pang ito sa halip na ipagpalagay na sapat ang headroom: ang self-hosted na AFFiNE workspace ay may apat pang container at may database sa likod ng mga ito, at inirerekomenda ng AFFiNE ang 2 GB RAM para sa basic usage at 4 GB para sa mga dokumentong lampas 10,000 salita. Para sa single-purpose na application gaya ng self-hosted na openGym workout tracker, bigyan ito ng sarili nitong TLS at alamin kung nasaan ang data folder nito bago mo ito pagtiwalaan ng isang taong training history. Ang anumang may web application, Postgres database, at background worker queue ay mas malapit sa dulo ng AFFiNE ng range na iyon, kaya magpasya kung ang self-hosted na Chatwoot support desk ay dapat ilagay sa server na ito o sa sarili nitong server bago mo matuklasan ang limitasyon sa kalagitnaan ng isang import. Mas kailangan ng pag-iingat sa mga bursty workload, dahil ang peak, hindi ang average, ang maaaring sumabay sa import: kung isinasaalang-alang mo ang self-hosted na OneCLI na nagbibigay sa bawat tao ng sarili nilang sandboxed agent, ikumpara ang published sizing numbers nito sa aktuwal na libreng resources habang todo-takbo ang qBittorrent, hindi sa ipinapakita ng free -h kapag idle ang box.

FAQ

Dahil naka-disable ang hardlinking, o nabibigo ang pagtatangkang gumawa ng hardlink. Nangyayari rin ito kapag magkaibang filesystem ang source at destination mula sa pananaw ng container. Ang dalawang magkahiwalay na bind mount, gaya ng /downloads at /tv, ay magkahiwalay na mount point kahit nagmumula ang mga ito sa iisang host disk. Hindi maaaring tumawid ang hardlink sa magkahiwalay na mount point. I-mount ang iisang parent directory bilang /data sa bawat container. Ilagay dito ang downloads at library para maging posible ang pag-link. Kumpirmahin ang resulta gamit ang stat -c '%i %h %n' sa parehong files. Kung nasa iisang filesystem ang mga ito, dapat magpakita ang mga ito ng parehong inode at link count na hindi bababa sa 2.

Anong PUID at PGID ang dapat kong gamitin?

Gamitin ang numeric id ng host account na nagmamay-ari ng media tree. Makukuha mo ito gamit ang id -u at id -g. Sa bagong Ubuntu VPS, karaniwang 1000 ang parehong value. Dapat gamitin ng bawat container sa stack ang parehong pair. Kung hindi, maaaring magsulat ng files ang isang application na hindi mabago ng ibang application. Pagkatapos baguhin ang mga value, muling likhain ang mga container gamit ang docker compose up -d --force-recreate. Ayusin ang mga kasalukuyang files gamit ang chown -R.

Kailangan ko bang ilantad sa internet ang mga web interface na ito?

Hindi, at hindi mo dapat gawin iyon. I-bind ang bawat published port sa 127.0.0.1 sa Compose file. Pagkatapos, i-access ang mga interface gamit ang SSH tunnel o reverse proxy sa server na nagte-terminate ng TLS (transport layer security) at nagdaragdag ng sarili nitong authentication. Sa Docker Engine 28.0.0 o mas bago, at gamit ang default bridge configuration, hindi maaabot ng VPN lamang ang port na naka-publish sa 127.0.0.1. Ginagawa ng Docker na maaabot lamang ng host mismo ang published port na iyon. Sa mas lumang Docker releases, maaabot ng mga host sa parehong local network segment ang mga port na naka-publish sa localhost. Kung kailangan mo ng direktang access sa pamamagitan ng VPN, i-publish ang mga port sa VPN address ng server. Mas mapanganib kaysa sa inaakala ang direktang pag-publish sa public interface. Naglalagay ang Docker ng sarili nitong firewall rules, kaya hindi mapipigilan ng ufw deny rule ang traffic na iyon.

Saan ko makikita ang password ng qBittorrent?

Ini-print ng LinuxServer.io image ang temporary password para sa admin user sa startup log nito. Patakbuhin ang docker compose logs qbittorrent | grep -i password upang basahin ito. Pagkatapos, magtakda ng permanenteng password sa ilalim ng Options at Web UI. Gumagawa ng bagong temporary password sa bawat restart hanggang magtakda ka ng sarili mong password.

Magagamit ba ng Jellyfin ang parehong folders?

Oo, at iyon ang layunin ng layout. I-mount ang /mnt/data/media sa media server bilang /media. Matatagpuan ang mga library nito sa /media/Movies at /media/Shows, habang nagsusulat ang Sonarr at Radarr sa parehong directories sa pamamagitan ng /data/media. Gamitin ng media server ang parehong PUID at PGID upang mabasa nito ang mga isinulat ng arr stack.

Nakatulong ba ang artikulong ito?

#sonarr#radarr#prowlarr#docker-compose#self-hosting