VPS-ல் Chaptarr மூலம் ஆடியோபுக் நிர்வகிப்பது எப்படி?

Chaptarr என்றால் என்ன, Readarr பயனர்களுக்கு அது ஏன் தேவை

Chaptarr என்பது Readarr-ன் ஒரு fork ஆகும். இது ஒரே instance-ல் இருந்து audiobook மற்றும் ebook-களை நிர்வகிக்கிறது. இது புதிய releases-ஐக் கண்காணித்து, அவற்றை உங்கள் download client-க்கு அனுப்பி, பின்னர் முடிவுகளை மறுபெயரிட்டு (rename) உங்கள் library-ல் கோப்புகளாகச் சேர்க்கிறது. இது எதையும் பிளே செய்யாது, எனவே Audiobookshelf போன்ற ஒரு player-உடன் இதை இணைக்க வேண்டும்.

Readarr 27 June 2025 அன்று நிறுத்தப்பட்டது. Servarr குழுவின் அறிவிப்பு அதற்கான காரணத்தைக் கூறுகிறது: திட்டத்தின் metadata பயன்படுத்த முடியாத நிலைக்குச் சென்றது, மேலும் Open Library-க்கு மாறுவதற்கான சமூக முயற்சி முடங்கியது. அந்த repository இப்போது காப்பகப்படுத்தப்பட்டுள்ளது (archived). இதனால் புத்தகம் மற்றும் audiobook சேகரிப்புகளை நிர்வகிக்க முறையான மென்பொருள் இல்லாமல் போனது, அந்தப் பணியை Chaptarr ஏற்றுக்கொண்டது. இது Sonarr மற்றும் Radarr-ல் உங்களுக்குத் தெரிந்த அதே கட்டமைப்பைக் கொண்டுள்ளது (indexers, download clients, quality profiles, root folders). அதனுடன் audiobook கையாளுதலையும் சேர்க்கிறது: narrator-ஐ அடிப்படையாகக் கொண்ட அமைப்பு, ஒரே தலைப்பில் பல பதிப்புகள் (editions), M4B மற்றும் chaptered MP3 ஆதரவு, மற்றும் MP3-லிருந்து M4B-க்கு மாற்றும் வசதி.

இந்த வழிகாட்டி chaptarr/chaptarr:0.9.925 image tag-ஐப் பயன்படுத்தியது, இது 9 August 2026 அன்று வெளியான புதிய release ஆகும். 11 October 2026 நிலவரப்படி, 27 September 2026 அன்று வெளியான 0.9.965 என்பதே புதிய release ஆகும். கீழே உள்ள படிகள் 0.9.925-ல் மட்டுமே சோதிக்கப்பட்டன, எனவே கோப்புகள் அந்த tag-ஐயே கொண்டுள்ளன; புதிய பதிப்பிற்கு மாறுவதற்கு முன் release notes-ஐப் படிக்கவும். Chaptarr தன்னை ஒரு beta மென்பொருள் என்று அழைக்கிறது. நீங்கள் மாற்ற முடியாத ஒரு library-ஐ இதனுடன் இணைக்கும் முன், இறுதியில் உள்ள பராமரிப்பு (maintenance) பகுதியைப் படிக்கவும்.

தொடங்குவதற்கு முன் உங்களுக்குத் தேவையானவை

Docker மற்றும் Compose plugin இயங்கும் ஒரு VPS, மற்றும் library-க்குத் தேவையான போதிய disk இடம். Audiobooks கோப்புகள் பெரியவை. Hardlinks பயன்படுத்த முடியாத ஒரு import செயல்முறை, கோப்பின் இரண்டு பிரதிகளைச் சிறிது காலம் வைத்திருக்கும். இதைப் பற்றி கீழே உள்ள volume பகுதியில் விளக்கப்பட்டுள்ளது. உங்கள் கணினியில் Docker இன்னும் நிறுவப்படவில்லை என்றால், VPS-ல் Docker நிறுவி இயக்குதல் என்ற பகுதியிலிருந்து தொடங்கிவிட்டு மீண்டும் இங்கே வரவும்.

Chaptarr தற்போது Docker image-ஆக மட்டுமே கிடைக்கிறது. Native support உருவாக்கத்தில் உள்ளது, மேலும் ஒரு experimental Windows build திட்டமிடப்பட்டுள்ளது. தற்போது எந்த distribution package-ம் இல்லை. இந்த container தனது database-ஐ இயல்பாக /config-ல் SQLite வடிவில் சேமிக்கிறது. நீங்கள் ஏற்கனவே PostgreSQL பயன்படுத்தினால், Chaptarr__Postgres__* environment variables மூலம் அதை இணைக்க முடியும். ஒரு கணினியில் ஒரு பயனர் பயன்படுத்துவதற்கு SQLite-யே சரியான தேர்வாகும்.

Chaptarr-க்கான Compose சேவை

இந்தச் சேவை ஏற்கனவே உள்ள stack-ல் இணைகிறது. இது ஒரு குறிப்பிட்ட released tag-ஐப் பயன்படுத்துகிறது, web UI-ஐ loopback-ல் மட்டும் வெளியிடுகிறது, மேலும் உங்கள் download client பயன்படுத்தும் அதே network-ல் இணைகிறது.

services:
  chaptarr:
    image: chaptarr/chaptarr:0.9.925
    container_name: chaptarr
    environment:
      - PUID=1000
      - PGID=1000
      - UMASK=002
      - TZ=Europe/Berlin
    volumes:
      - ./config:/config
      - /srv/media/audiobooks:/audiobooks
      - /srv/media/ebooks:/ebooks
      - /srv/media/downloads:/downloads
    ports:
      - 127.0.0.1:8789:8789
    restart: unless-stopped
    networks:
      - arr

networks:
  arr:
    external: true

external: true வரி "இந்த network ஏற்கனவே உள்ளது, இதனுடன் இணையவும்" என்று பொருள்படும். Prowlarr மற்றும் உங்கள் torrent client ஆகியவை வெவ்வேறு Compose project-ல் இருக்கும்போது இதைப் பயன்படுத்தவும். ஏனெனில், இல்லையெனில் இரண்டாவது Compose கோப்பு தனக்கென ஒரு தனிமைப்படுத்தப்பட்ட network-ஐ உருவாக்கிவிடும், அப்போது Chaptarr-ஆல் qbittorrent-ஐ பெயரைக் கொண்டு கண்டறிய முடியாது. docker network ls மூலம் உண்மையான பெயரைப் பெறவும். உங்கள் stack ஏற்கனவே ஒரே கோப்பில் இருந்தால், chaptarr: சேவையை அந்த கோப்பில் சேர்த்துவிட்டு, முழு networks: தொகுதியையும் நீக்கிவிடவும். விரிவான அமைப்பு Docker Compose-ன் கீழ் முழுமையான arr stack என்பதிலும், பெயரிடும் விதிகள் Compose networks மற்றும் service பெயர்கள் எவ்வாறு செயல்படுகின்றன என்பதிலும் விளக்கப்பட்டுள்ளன.

config கோப்பகத்தை நீங்களே உருவாக்கிவிட்டு, சேவையைத் தொடங்கவும்.

mkdir -p ./config
sudo chown 1000:1000 ./config
docker compose up -d
docker compose ps
docker compose logs -f chaptarr

docker compose ps கட்டளை container-ஐ Up நிலையில் காட்ட வேண்டும். Restarting என்று பட்டியலிடப்பட்ட container தொடங்கத் தவறிவிட்டது மற்றும் மீண்டும் தொடங்க முயற்சிக்கிறது; அதன் logs-ஐப் படித்து காரணத்தைக் கண்டறியவும். செயலி 8789 port-ல் இயங்கத் தொடங்கியதும் log நகர்வது நின்றுவிடும்.

PUID, PGID மற்றும் root பயனராக Docker உருவாக்கும் கோப்பகம்

நீங்கள் PUID=99 மற்றும் PGID=100 ஆகியவற்றை அமைக்காமல் விடும்போது, Chaptarr இயல்பாகவே அந்த மதிப்புகளைப் பயன்படுத்தும். அவை unRAID-ன் மதிப்புகள்; சாதாரண Ubuntu VPS-ல் அவை எந்தப் பயனுள்ள பயனருக்கும் உரியவை அல்ல. எனவே, உங்கள் login பயனரால் எழுத முடியாத உரிமையாளருடன் கோப்புகள் உருவாக்கப்படும். id -u மற்றும் id -g கட்டளைகளைப் பயன்படுத்தி உங்கள் சொந்த எண்களைக் கண்டறிந்து, அவற்றை கோப்பில் உள்ளிடவும்.

ஒரே கோப்புகளை அணுகும் ஒவ்வொரு container-க்கும் ஒரே ஜோடி மதிப்புகள் தேவை. பதிவிறக்க client /srv/media/downloads-ல் கோப்புகளை எழுதுகிறது, Chaptarr அதை /srv/media/audiobooks-க்கு நகர்த்துகிறது, player அதை அங்கிருந்து படிக்கிறது. பதிவிறக்க client 1000:1000 பயனராகவும், Chaptarr 99:100 பயனராகவும் இயங்கினால், import தோல்வியடையும். கோப்பின் உரிமையாளர் யார் என்பது முக்கியமல்ல; ஒரு கோப்பை உருவாக்குவது, பெயர் மாற்றுவது அல்லது நீக்குவதற்கு அந்தக் கோப்பகம் அமைந்துள்ள directory-ல் எழுதும் அனுமதி (write permission) தேவை. பயனர் 1000 மற்றும் பொதுவான 755 mode-ல் உருவாக்கப்பட்ட கோப்பகங்கள் 99:100-க்கு எழுதும் அனுமதியை வழங்காது. எனவே, Chaptarr-ஆல் புத்தகத்தை library-ல் சேர்க்கவோ அல்லது பதிவிறக்கக் கோப்பகத்திலிருந்து நீக்கவோ முடியாது. UMASK=002 புதிய கோப்புகளை group-writable ஆக்குகிறது; பல container-கள் ஒரே media group-ஐப் பகிரும்போது இதுவே உங்களுக்குத் தேவைப்படும். முழுமையான மேப்பிங் விவரங்கள் PUID மற்றும் PGID எவ்வாறு container பயனரை host கோப்புகளுடன் இணைக்கிறது என்பதில் உள்ளது.

முதலில் config கோப்பகத்தை உருவாக்கி, Compose user: override-ஐத் தவிர்க்குமாறு README பரிந்துரைக்கிறது. நீங்கள் docker compose up-ஐ இயக்கும்போது ./config இல்லையென்றால், Docker அதை உங்களுக்காக உருவாக்கும்; அதன் உரிமையாளர் root:root ஆக இருப்பார். pinned 0.9.925 image-ல், entrypoint root பயனராகத் தொடங்கி, /config மற்றும் அதன் database கோப்புகளின் உரிமையைச் சரிசெய்த பிறகு, கட்டமைக்கப்பட்ட UID மற்றும் GID-க்கு மாறுகிறது. எனவே, புதிதாக உருவாக்கப்பட்ட root-க்குச் சொந்தமான கோப்பகம் பொதுவாக restart loop-ஐ ஏற்படுத்தாது. ஒரு user: override அந்த அமைப்பைத் தவிர்க்கும். மேலும், read-only mount அல்லது உரிமையாளர் மாற்றத்தை அனுமதிக்கும் filesystem, database-ல் எழுதுவதைத் தடுக்கலாம். ls -ln ./config கட்டளையைப் பயன்படுத்திச் சரிபார்க்கவும்; இது பெயர்களுக்குப் பதிலாக எண் உரிமையாளர்களைக் காட்டும். இரண்டு பூஜ்ஜியங்கள் இருந்தால், அது root-க்குச் சொந்தமானது என்று பொருள். எழுதக்கூடிய local directory-ல் அனுமதிச் சிக்கல் இருப்பதாக logs உறுதிப்படுத்தினால், sudo chown -R 1000:1000 ./config மூலம் அதைச் சரிசெய்து, container-ஐ மீண்டும் தொடங்கவும்.

ஆடியோபுக் மற்றும் ஈபுக் தொகுதிகளைத் தனித்தனியாகப் பிரிப்பது ஏன் hardlinks-ஐப் பாதிக்கிறது

மேலே உள்ள அமைப்பு /audiobooks, /ebooks மற்றும் /downloads ஆகியவற்றைத் தனித்தனி binds-ஆக மவுண்ட் செய்கிறது, இது அந்தத் திட்டத்தின் சொந்த run கட்டளைக்கு இணங்க உள்ளது. இதைப் புரிந்துகொள்வது எளிது, ஆனால் இதில் ஒரு முக்கிய சிக்கல் உள்ளது: hardlinks வேலை செய்யாது.

Hardlink என்பது வட்டில் உள்ள அதே தரவிற்கான இரண்டாவது பெயராகும். இது கூடுதல் இடத்தைப் பயன்படுத்தாது மற்றும் உடனடியாகச் செயல்படும், இதனால்தான் arr குடும்ப மென்பொருள்கள் கோப்புகளை நகலெடுப்பதை விட இதை விரும்புகின்றன. ஒரு hardlink ஒரே filesystem-க்குள் மட்டுமே வேலை செய்யும். கொள்கலனுக்குள் (container) இவை மூன்று தனித்தனி மவுண்ட் புள்ளிகளாக இருப்பதால், host பாதைகள் ஒரே வட்டில் இருந்தாலும் kernel இந்த இணைப்பை மறுத்துவிடும். நீங்களே இதைச் சோதித்துப் பாருங்கள்.

docker exec chaptarr sh -c 'touch /downloads/linktest && ln /downloads/linktest /audiobooks/linktest'

இந்தக் கட்டளை Invalid cross-device link என்று முடியும் பிழையுடன் தோல்வியடையும். மவுண்ட் புள்ளிகளுக்கு இடையே இணைப்பை ஏற்படுத்த kernel மறுப்பதே இதற்குக் காரணம், இதனால்தான் Chaptarr கோப்பை நகலெடுக்கும் முறைக்கு மாறுகிறது. நகல் சரியாக இருந்தாலும் அது மெதுவானது, மேலும் நீங்கள் torrent-ஐ seeding செய்யும் வரை அதை நீக்க மாட்டீர்கள் என்பதால், ஆடியோபுக் இரண்டு முறை வட்டில் இருக்கும். அதன் பிறகு /srv/media/downloads/linktest-ஐ நீக்கவும்.

Hardlinks-ஐத் தக்கவைக்க, அதற்குப் பதிலாக ஒரு parent directory-ஐ மவுண்ட் செய்யவும்:

    volumes:
      - ./config:/config
      - /srv/media:/data

பிறகு Chaptarr-க்குள் உள்ள root folders-ஐ /data/audiobooks மற்றும் /data/ebooks என அமைக்கவும், மேலும் download client-க்கு அதே /srv/media:/data மவுண்ட்டைக் கொடுக்கவும், அப்போதுதான் இரண்டு கொள்கலன்களும் ஒரே மாதிரியான பாதையைப் பார்க்கும். host பக்கத்தில் ஒரே filesystem உள்ளதா என்பதை முதலில் உறுதிப்படுத்தவும்: df -h /srv/media/downloads /srv/media/audiobooks கட்டளை இரண்டுக்கும் Filesystem நெடுவரிசையில் ஒரே மதிப்பைக் காட்ட வேண்டும். வெவ்வேறு மதிப்புகள் இருந்தால் அவை வெவ்வேறு வட்டுகள் என்று பொருள், எந்த மவுண்ட் அமைப்பாலும் அவற்றுக்கு இடையே hardlink செய்ய முடியாது. இதற்கும் named storage-க்கும் இடையிலான வேறுபாடுகள் ஊடகங்களுக்கான bind mounts மற்றும் named volumes ஒப்பீடு பகுதியில் விளக்கப்பட்டுள்ளன.

இணைய இடைமுகத்தை (web UI) வெளிப்படுத்தாமல் அணுகுதல்

127.0.0.1-ல் port-ஐ வெளியிடுவதற்கு ஒரு காரணம் உள்ளது. Docker ஒரு port-ஐ வெளியிடும்போது, ufw deny 8789 அதை முழுமையாகப் பாதுகாப்பதில்லை. ஏனெனில், Docker தனது சொந்த NAT (network address translation) விதிகளை kernel-ன் சங்கிலியில் (chain) எழுதும்; இது ufw விதிகளை விட முன்னதாகவே செயல்படும். எனவே, உங்கள் விதிகள் சரிபார்க்கப்படுவதற்கு முன்பே traffic முன்னோக்கி அனுப்பப்பட்டுவிடும். இந்தச் செயல்பாடு பலரைத் தவறாக வழிநடத்துகிறது. இது ஏன் வெளியிடப்பட்ட Docker port உங்கள் ufw விதிகளைப் புறக்கணிக்கிறது என்பதில் விளக்கப்பட்டுள்ளது. Loopback-ல் bind செய்வதன் மூலம் இதை முழுமையாகத் தவிர்க்கலாம்.

உங்கள் கணினியிலிருந்து SSH tunnel வழியாக web UI-ஐ அணுகவும்:

ssh -N -L 8789:127.0.0.1:8789 you@your-server

அதை இயங்கவிட்டு, உங்கள் browser-ல் http://127.0.0.1:8789-ஐத் திறக்கவும். முதல்முறை இயக்கும்போது authentication-ஐ அமைக்கவும். அதற்குப் பிறகு மட்டுமே, அதன் முன்னால் TLS (transport layer security) கொண்ட reverse proxy-ஐப் பயன்படுத்துவதைப் பற்றிச் சிந்திக்கவும். இதுபோன்ற மூன்று அல்லது நான்கு கருவிகளைத் தனித்தனி கடவுச்சொற்களுடன் tunnel மூலம் அணுகத் தொடங்கிய பிறகு, Authentik போன்ற ஒரு self-hosted single sign-on server-ஐ proxy-க்கு பின்னால் வைப்பதே சிறந்த தீர்வாகும். இதன் மூலம் ஒரே login-ல் அனைத்து app-களையும் அணுக முடியும், மேலும் ஒரே revocation மூலம் அனைத்தையும் மூட முடியும்.

Indexers மற்றும் download client-ஐ இணைத்தல்

Chaptarr, standard arr indexer மற்றும் download client protocols-ஐ ஆதரிக்கிறது. எனவே, Prowlarr மூலம் indexer-களை Sonarr-க்கு இணைப்பது போலவே இதற்கும் இணைக்கலாம். வழக்கமான torrent மற்றும் usenet client-களை எந்தவித கூடுதல் மாற்றமும் இன்றி இணைக்க முடியும்.

ஒரு குறிப்பிட்ட அமைப்பு மட்டும் பலருக்கும் குழப்பத்தை ஏற்படுத்துகிறது. Chaptarr-ல் download client host-ஐ உள்ளிடும்போது, localhost அல்லது 127.0.0.1 என்று தட்டச்சு செய்ய வேண்டாம். Container-க்குள் அந்த முகவரி என்பது அந்த container-ஐயே குறிக்கும். எனவே, Chaptarr தனது சொந்த port 8080-ல் தொடர்பு கொள்ள முயன்று, இணைக்க முடியவில்லை என்று பிழையைக் காட்டும். அதற்குப் பதிலாக, container-ன் பெயரான qbittorrent மற்றும் port 8080-ஐப் பயன்படுத்தவும். docker network inspect arr கட்டளையைப் பயன்படுத்தி, இரண்டு container-களும் ஒரே network-ல் இருப்பதை உறுதிப்படுத்தவும்; இது இணைக்கப்பட்டுள்ள அனைத்து container-களின் பெயர்களையும் பட்டியலிடும்.

உங்கள் download client ஒரு VPN container வழியாக network_mode: "service:gluetun" மூலம் இயங்கினால், அதற்கு network-ல் தனிப்பெயர் இருக்காது, ஏனெனில் அது Gluetun-ன் network namespace-ஐப் பகிர்ந்து கொள்கிறது. எனவே, Gluetun வெளிப்படுத்தும் port-ல் அதை gluetun என்று குறிப்பிடவும். அந்த அமைப்பு மற்றும் அதனுடன் தொடர்புடைய routing விவரங்களை routing a download client through Gluetun பகுதியில் காணலாம்.

Readarr மாற்றம்: இடம்பெயர்வுக்கான உண்மையான செலவு

Chaptarr, Readarr-ன் metadata ஆதாரங்களுடன் இணக்கமானது அல்ல. இது தலைப்புகள், ஆசிரியர்கள் மற்றும் பதிப்புகளைப் பல வழங்குநர்கள் வழியாகத் தனது சொந்த pipeline மூலம் கண்டறிகிறது, எனவே Readarr சேமித்து வைத்திருந்த identifiers இங்கே பயன்படாது. இதில் database import வசதியோ அல்லது எளிதான upgrade வழியோ இல்லை.

ஏற்கனவே உள்ள ஒரு library-க்கு, கோப்புகள் (files) பாதுகாப்பாக இருக்கும், ஆனால் அமைப்புகள் (settings) இருக்காது. இந்தச் செயல்பாட்டில் வட்டில் (disk) உள்ள எதையும் மாற்ற முடியாது. நீங்கள் ஒரு root folder-ஐச் சேர்த்து, library import-ஐ இயக்க வேண்டும்; அப்போது Chaptarr கண்டறியும் கோப்புகளைத் தனது சொந்த metadata-வுடன் ஒப்பிட்டுப் பார்க்கும். நீங்கள் கைமுறையாக மீண்டும் உருவாக்க வேண்டியவை: quality profiles, naming format, indexer மற்றும் client அமைப்புகள், மற்றும் Chaptarr தவறாகக் கணிக்கும் ஒவ்வொரு பொருத்தம் (match). பெரிய library-ஆக இருந்தால், கைமுறையாகச் சரிசெய்ய வேண்டியிருக்கும், எனவே பத்து நிமிடங்களுக்குப் பதிலாக ஒரு மாலைப் பொழுதை இதற்காக ஒதுக்குங்கள்.

இதை இந்த வரிசையில் செய்யுங்கள். Readarr container-ஐ நிறுத்துங்கள், ஆனால் அதன் config volume-ஐ அப்படியே வைத்திருங்கள், அப்போதுதான் பழைய அமைப்புகளைப் பார்த்துப் புதியதில் உள்ளிட முடியும். முதலில் ஒரு சிறிய folder-ஐ மட்டும் Chaptarr-ல் காட்டி, அனைத்தையும் import செய்வதற்கு முன் பொருத்தங்களைச் சரிபார்க்கவும். நீங்கள் திருப்தியடைந்த பிறகு மட்டும் பழைய container-ஐ நீக்கவும்.

முழு library-ஐயும் scan செய்வதற்கு முன் தெரிந்துகொள்ள வேண்டிய ஒரு தனியுரிமை விவரம்: metadata தேடல்கள் api2.chaptarr.com-க்குச் செல்லும். அந்தத் தேடல்களில் provider IDs, search text, media type, tags மற்றும் filenames ஆகியவை இருக்கலாம் என்றும், முழுமையான paths, பயனர் அடையாளம் மற்றும் credentials ஆகியவை தவிர்க்கப்படும் என்றும் README கூறுகிறது. கோப்புப் பெயர்கள் (filenames) உங்கள் server-ஐ விட்டு வெளியேறும். இது ஒரு metadata சேவைக்கு இயல்பானது, இருப்பினும் இதை நீங்கள் கவனமாக முடிவு செய்ய வேண்டும்.

ஆடியோபுக்குகளை ஒரு பிளேயருக்கு அனுப்புதல்

Chaptarr கோப்புகளை ஒழுங்கமைக்கிறது. அவற்றை இயக்குவது மற்றொரு நிரலின் வேலை. நீங்கள் எந்த சாதனத்தில் கேட்கிறீர்கள் என்பதைத் தொடர்ந்து கண்காணிப்பதற்கும், மொபைல் செயலிகளைக் கொண்டிருப்பதற்கும் Audiobookshelf பொதுவாகப் பயன்படுத்தப்படுகிறது. இதன் அதிகாரப்பூர்வ image ghcr.io/advplyr/audiobookshelf:latest ஆகும். இதன் ஆவணப்படுத்தப்பட்ட Compose எடுத்துக்காட்டு, host port 13378-ஐ container port 80-க்கு வெளியிடுகிறது.

  audiobookshelf:
    image: ghcr.io/advplyr/audiobookshelf:latest
    container_name: audiobookshelf
    ports:
      - 127.0.0.1:13378:80
    volumes:
      - ./abs/config:/config
      - ./abs/metadata:/metadata
      - /srv/media/audiobooks:/audiobooks
    environment:
      - TZ=Europe/Berlin
    restart: unless-stopped

Chaptarr எழுதும் அதே host path-ஐ mount செய்யவும். பின்னர், web UI-க்குள் ஒரு library-ஆக /audiobooks-ஐச் சேர்க்கவும். அடுத்த ஸ்கேனுக்குப் பிறகு புதிய இறக்குமதி (import) தோன்றும்.

நீங்கள் ஏற்கனவே Jellyfin பயன்படுத்துகிறீர்கள் என்றால், அந்த கோப்புறையை (folder) அங்கு ஒரு library-ஆகச் சேர்க்கலாம்; அது கோப்புகளை இயக்கும். அந்த அமைப்பை எவ்வாறு செய்வது என்பது VPS-ல் மீடியா சர்வராக Jellyfin-ஐ இயக்குதல் என்ற பகுதியில் விளக்கப்பட்டுள்ளது. மின்புத்தகங்களைப் (ebooks) பொறுத்தவரை, /srv/media/ebooks-ஐ ஒரு ரீடர் செயலிக்கு அனுப்பவும்; கோப்பு பெயரிடப்பட்டு சேமிக்கப்பட்டவுடன் Chaptarr-ன் வேலை முடிவடைகிறது.

பராமரிப்பு அபாயம்: உரிமம், இயக்கநேரம் மற்றும் வேகமான tag மாற்றங்கள்

Chaptarr, GPL-3.0 உரிமத்தின் கீழ் உள்ளது. இதன் பதிப்புரிமை Chaptarr பங்களிப்பாளர்களுக்கும், Servarr குழுவின் சில பகுதிகளுக்கும் உரியது. எனவே, இந்த மென்பொருள் திறந்த மூலமாகவே இருக்கும்; தற்போதைய பராமரிப்பாளர் நிறுத்தினால், எவரும் இதை மீண்டும் fork செய்ய முடியும். இது .NET 10-ல் கட்டமைக்கப்பட்டுள்ளது. இது ஆகஸ்ட் 2026 நிலவரப்படி, நீண்ட கால ஆதரவு (LTS) கொண்ட runtime பதிப்பாகும். அதாவது, இதன் அடிப்படை பல மாதங்களுக்குப் பதிலாக பல ஆண்டுகளுக்கு ஆதரவு பெறும். அடுத்த ஆண்டு இந்தத் திட்டம் இருக்குமா என்று நீங்கள் மதிப்பிடும்போது, இந்த இரண்டு உண்மைகளும் முக்கியம்.

பதிப்பு எண்கள் வேகமாக மாறுகின்றன. 0.9.925 பதிப்பு 9 ஆகஸ்ட் 2026 அன்று வெளியிடப்பட்டது. அடுத்த ஏழு வாரங்களில் மேலும் ஐந்து வெளியீடுகள் வந்தன. 0.9.958 வரையிலான ஒவ்வொரு வெளியீடும் pre-release ஆக வெளியிடப்பட்டது; 27 செப்டம்பர் 2026 அன்று வந்த 0.9.965 தான் முழுமையான வெளியீடாகக் குறிக்கப்பட்டுள்ளது. ஒரு குறிப்பிட்ட tag-ஐ pin செய்யவும். latest-ஐப் பயன்படுத்துவது என்றால், கவனிக்கப்படாத docker compose pull ஒரு வாரத்தில் உங்களை பல பதிப்புகள் முன்னோக்கி நகர்த்தக்கூடும். இவ்வளவு புதிய ஒரு fork, வெளியீடுகளுக்கு இடையே அதன் API-ஐ மாற்றக்கூடும். இது நீங்கள் அதற்காக எழுதிய எந்த script அல்லது dashboard-ஐயும் செயலிழக்கச் செய்யும். நீங்கள் சுயமாக host செய்யும் ஒவ்வொரு புதிய திட்டத்திற்கும் pin செய்யும் பழக்கத்தை ஏற்படுத்திக்கொள்வது நல்லது. இதனால்தான் openGym-ஐ self-hosted workout tracker-ஆக இயக்குவதற்கான வழிகாட்டி, அதே காரணத்திற்காக ஒரு நிலையான git tag-லிருந்து deploy செய்கிறது.

ஒவ்வொரு upgrade-க்கு முன்பும் backup எடுக்கவும், பிறகு திட்டமிட்டு upgrade செய்யவும்.

docker compose stop chaptarr
sudo tar czf chaptarr-config-backup.tgz ./config
docker compose start chaptarr

docker compose pull chaptarr
docker compose up -d chaptarr

இந்தத் திட்டம் சுமார் ஆறு மாதங்களில், பதினோராயிரம் பயனர்களுக்கு மேல் எந்தத் தரவு இழப்பு நிகழ்வுகளையும் பதிவு செய்யவில்லை. இருப்பினும், backup வைத்துக்கொள்ளவும், இழக்க முடியாத library-களுடன் இதை இணைக்க வேண்டாம் என்றும் அறிவுறுத்துகிறது. இரண்டையும் தீவிரமாகக் கவனியுங்கள். config archive-ஐ server-லிருந்து வெளியே நகலெடுக்கவும். ஏனெனில், அது பாதுகாக்கும் அதே disk-ல் இருக்கும் backup, உண்மையான backup ஆகாது. அந்த ஒற்றை tarball, /config-க்கு கீழ் உள்ள SQLite databases மற்றும் configuration-ஐ உள்ளடக்கியிருப்பதால், app-ன் local state-ஐ முழுமையாகப் பாதுகாக்கும். தனித்தனி database server-ல் இருக்கும் எதற்கும், database-ஐ dump செய்ய வேண்டும். Chatwoot-ஐ VPS-ல் self-host செய்யும்போது, அதன் Postgres தரவு மற்றும் பதிவேற்றப்பட்ட கோப்புகளுடன் backup எடுக்கும் முறை இதுவே.

தோல்வி முறைகள் மற்றும் நீங்கள் காணும் செய்திகள்

Container மீண்டும் மீண்டும் restart ஆகிறது. docker compose ps-ல் Restarting காட்டப்படுகிறது. முதலில் docker compose logs chaptarr-ஐப் படிக்கவும். root உரிமையுள்ள ./config மட்டும் இந்த loop-க்குக் காரணமல்ல: பொதுவாக entrypoint, application-ஐத் தொடங்குவதற்கு முன்பே அதன் உரிமையைச் சரிசெய்துவிடும். தரவு அடைவு (data directory) எழுதக்கூடிய நிலையில் இல்லை என்று logs காட்டினால், Compose user: override, read-only mount அல்லது உரிமையை மாற்ற அனுமதிக்காத filesystem உள்ளதா என்று சரிபார்க்கவும். entrypoint தனது அமைப்புகளைச் செய்ய ஏதுவாக override-ஐ நீக்கவும்; எழுதக்கூடிய உள்ளூர் அடைவில் தவறான உரிமை இருந்தால், sudo chown -R 1000:1000 ./config கட்டளையை இயக்கவும்.

Imports முடிவடைவதில்லை மற்றும் கோப்புகள் downloads-லேயே இருக்கின்றன. Chaptarr-ஆல் download-ஐப் படிக்க முடிகிறது, ஆனால் library-க்குள் எழுத முடியவில்லை. உங்கள் PUID மற்றும் PGID உடன் ls -ln /srv/media/audiobooks-ஐ ஒப்பிட்டுப் பார்க்கவும். வேறொரு UID-க்குச் சொந்தமான அடைவு அல்லது group write அனுமதி இல்லாத அடைவு கோப்பு நகர்த்தப்படுவதைத் தடுக்கும். புதிய கோப்புகளுக்கு UMASK=002 இந்த இரண்டாவது சிக்கலைத் தவிர்க்கும்.

ஒவ்வொரு import-க்குப் பிறகும் வட்டு பயன்பாடு (disk usage) இருமடங்காகிறது. Hardlink உருவாக்கப்படவில்லை, எனவே கோப்பு நகலெடுக்கப்பட்டுள்ளது (copied). Volumes பகுதியில் உள்ள ln சோதனையை இயக்கவும். Invalid cross-device link என முடியும் பிழை ஏற்பட்டால், single-parent mount-ஐப் பயன்படுத்துவதே இதற்கான தீர்வு.

Download client இணைக்கப்படவில்லை. நீங்கள் host-ஆக localhost-ஐக் குறிப்பிட்டுள்ளீர்கள். Container-க்குள் அது Chaptarr-ஐயே குறிக்கும். Container பெயரைப் பயன்படுத்தவும் மற்றும் docker network inspect arr-ல் இரண்டு container-களும் பட்டியலிடப்பட்டுள்ளதா என்று சரிபார்க்கவும்.

Compose சேவையைத் தொடங்க மறுக்கிறது. Bind for 127.0.0.1:8789 failed: port is already allocated என்றால், அந்த port-ஐ வேறொரு சேவை பயன்படுத்துகிறது என்று பொருள். sudo ss -lntp | grep 8789 மூலம் அதைக் கண்டறியவும்.

Browser-ல் எதுவும் தெரியவில்லை. Port 127.0.0.1-ல் பிணைக்கப்பட்டிருக்கும்போது, இணையம் வழியாக உங்கள் மடிக்கணினியால் எதையும் இணைக்க முடியாது. இதுவே எதிர்பார்க்கப்படும் செயல்பாடு. முதலில் SSH tunnel-ஐத் திறக்கவும்.

FAQ

எனது Readarr library-ஐ Chaptarr-க்கு மாற்ற முடியுமா?

இறக்குமதி (import) செய்ய முடியாது. Readarr-ன் metadata ஆதாரங்கள் Chaptarr-க்கு ஒத்துப்போகாது; இது தனது சொந்த provider pipeline-ஐப் பயன்படுத்துகிறது. எனவே, Readarr-ல் சேமிக்கப்பட்ட identifiers-க்கு எந்த மதிப்பும் இல்லை, மேலும் database-ஐ மாற்றும் வசதியும் இல்லை. உங்கள் வட்டில் (disk) உள்ள கோப்புகள் பாதிக்கப்படாது. நீங்கள் அதே பாதைகளை root folders-ஆகச் சேர்த்து, library import-ஐ இயக்க வேண்டும்; Chaptarr தானாகவே கோப்புகளைப் பொருத்திக்கொள்ளும். Quality profiles, naming format, indexer settings மற்றும் தவறான பொருத்தங்களை நீங்களே சரிசெய்ய வேண்டும். எனவே, அனைத்தையும் இறக்குமதி செய்வதற்கு முன் ஒரு சிறிய கோப்புறையில் (folder) சோதனை செய்யவும்.

எனது audiobook கோப்புறையில் Chaptarr ஏன் எழுத முடியவில்லை?

Container-ன் பயனருக்கு அந்த directory-ல் எழுதும் அனுமதி (write permission) இல்லை. பொதுவாக, கோப்பின் உரிமையாளரும் container இயங்கும் UID-ம் வெவ்வேறாக இருப்பதே இதற்குக் காரணம். PUID=99 மற்றும் PGID=100 மாறிகள் (variables) அமைக்கப்படாதபோது Chaptarr அவற்றைப் பயன்படுத்தும்; இவை unRAID-க்கான மதிப்புகள், சாதாரண Ubuntu VPS-க்கு இவை பொருந்தாது. அவற்றை உங்கள் சொந்த id -u மற்றும் id -g மதிப்புகளுக்கு அமைக்கவும். அதே ஜோடியை download client-லும் பயன்படுத்தவும். புதிய கோப்புகள் group-writable நிலையில் இருக்க UMASK=002-ஐ அமைக்கவும். library directory-ல் ls -ln கட்டளையைப் பயன்படுத்தி உரிமையைச் சரிபார்க்கவும்; இது பெயர்களுக்குப் பதிலாக எண்களைக் காட்டுவதால், அவற்றை ஒப்பிட்டுப் பார்க்க முடியாது.

இறக்குமதி செய்த பிறகு எனது disk பயன்பாடு ஏன் இருமடங்கானது?

கோப்பை hardlink செய்ய முடியாததால் Chaptarr அதை நகல் (copy) எடுத்துள்ளது. /downloads மற்றும் /audiobooks ஆகியவற்றைத் தனித்தனி binds-ஆக mount செய்வது, container-க்குள் அவற்றை வெவ்வேறான mount points-ஆக மாற்றுகிறது. mount points-க்கு இடையே hardlink செய்வதை kernel Invalid cross-device link பிழையுடன் தடுக்கும். /srv/media:/data போன்ற ஒரு பொதுவான parent directory-ஐ mount செய்து, app-க்குள் /data/downloads மற்றும் /data/audiobooks ஆகியவற்றைப் பயன்படுத்தவும். இரண்டு பாதைகளும் ஒரே host filesystem-ல் இருக்க வேண்டும், இதை df -h உறுதிப்படுத்தும்.

Chaptarr எனது audiobook-களை ஒலிபரப்புமா (play)?

இல்லை. இது கோப்புகளைக் கண்டறிந்து, பதிவிறக்கம் செய்து, பெயர் மாற்றி, வரிசைப்படுத்தும். ஒலிபரப்புவது ஒரு தனி மென்பொருளின் வேலை. Audiobookshelf பொதுவாக இதனுடன் பயன்படுத்தப்படுகிறது, ஏனெனில் இது சாதனங்களுக்கு இடையே நீங்கள் கேட்ட இடத்தைச் சேமித்து வைக்கும். இதற்கு அதிகாரப்பூர்வ image ghcr.io/advplyr/audiobookshelf:latest-ஐப் பயன்படுத்தவும், அதே host audiobook பாதையை mount செய்யவும். நீங்கள் கோப்புறையை library-ஆகச் சேர்த்தால், Jellyfin மூலமும் கோப்புகளை ஒலிபரப்பலாம்.

நான் பாதுகாக்கும் library-ல் Chaptarr-ஐ இயக்குவது பாதுகாப்பானதா?

இது ஒரு புதிய fork-ல் இருந்து வந்த beta மென்பொருள். சுமார் ஆறு மாதங்களில், பதினோராயிரம் பயனர்களுக்கு மேல் இதைப் பயன்படுத்தியதில் தரவு இழப்பு (data loss) எதுவும் பதிவாகவில்லை என்று திட்டக்குழு கூறுகிறது. GPL-3.0 உரிமம் குறியீட்டை fork செய்ய அனுமதிக்கிறது, மேலும் .NET 10 என்பது ஆகஸ்ட் 2026 நிலவரப்படி நீண்ட கால ஆதரவு (long term support) கொண்ட runtime ஆகும். latest-க்கு பதிலாக 0.9.925 போன்ற துல்லியமான image tag-ஐப் பயன்படுத்தவும். ஒவ்வொரு upgrade-க்கு முன்பும் /config-ஐ backup எடுக்கவும், அந்த archive-ஐ server-க்கு வெளியே பாதுகாப்பாக வைக்கவும்.