VPSలో Chaptarr self-host: audiobooks కోసం పూర్తి setup

Chaptarr అంటే ఏమిటి, Readarr వినియోగదారులకు ఇది ఎందుకు అవసరం

Chaptarr అనేది Readarr యొక్క fork. ఇది ఒకే instance నుంచి audiobooks మరియు ebooks ను నిర్వహిస్తుంది. ఇది కొత్త releases కోసం పర్యవేక్షించి, వాటిని మీ download client కు పంపుతుంది. తరువాత ఫలితాలను rename చేసి, మీ library లో సక్రమంగా ఉంచుతుంది. ఇది ఏదీ play చేయదు. అందువల్ల దీన్ని Audiobookshelf వంటి player తో కలిపి ఉపయోగించాలి.

Readarr ను 27 June 2025న retire చేశారు. Servarr team ఇచ్చిన స్వంత ప్రకటనలో కారణం వివరించబడింది: project metadata ఉపయోగించలేని స్థితికి చేరింది. Open Library కు మారే community ప్రయత్నం కూడా నిలిచిపోయింది. Repository archive చేయబడింది. దాంతో books మరియు audiobooks collections కు నిర్వహణలో ఉన్న manager లేకుండా పోయింది. Chaptarr ఆ బాధ్యతను స్వీకరించింది. ఇది Sonarr మరియు Radarr నుంచి మీకు ఇప్పటికే తెలిసిన నిర్మాణాన్ని కొనసాగిస్తుంది: indexers, download clients, quality profiles, root folders. అదనంగా audiobook నిర్వహణను అందిస్తుంది: narrator ఆధారిత organisation, ఒకే title కు multiple editions, M4B మరియు chaptered MP3 support, అలాగే MP3 నుంచి M4B conversion.

ఈ walkthrough లో chaptarr/chaptarr:0.9.925 image tag ఉపయోగించబడింది. 9 August 2026న ఇది అందుబాటులో ఉన్న newest release. Chaptarr తనను beta software గా పేర్కొంటుంది. మీరు తిరిగి పొందలేని library కు దీన్ని అనుసంధానించే ముందు, చివర్లో ఉన్న maintenance section ను చదవండి.

ప్రారంభించే ముందు మీకు అవసరమైనవి

Docker మరియు Compose plugin నడుస్తున్న VPS, అలాగే library కోసం తగినంత disk space అవసరం. Audiobooks పెద్దవిగా ఉంటాయి. Hardlinks ఉపయోగించలేని import కొంతకాలం ఒక file యొక్క రెండు copies ను ఉంచుతుంది. దీన్ని దిగువ volume విభాగంలో వివరించాం. మీ VPS లో Docker ఇంకా లేకపోతే, VPS లో Docker ను ఇన్‌స్టాల్ చేసి నడపడం తో ప్రారంభించి, తరువాత ఇక్కడికి తిరిగి రండి.

ప్రస్తుతం Chaptarr ఒక Docker image గా మాత్రమే అందుబాటులో ఉంది. Native Windows build అభివృద్ధిలో ఉన్నట్లు పేర్కొన్నారు. Distribution package అందుబాటులో లేదు. Container తన database ను డిఫాల్ట్‌గా SQLite గా /config లో నిల్వ చేస్తుంది. మీరు ఇప్పటికే PostgreSQL server నడుపుతున్నట్లయితే, Chaptarr__Postgres__* environment variables ద్వారా దాన్ని ఉపయోగించవచ్చు. ఒకే box పై ఒకే user కోసం SQLite సరైన ఎంపిక.

Chaptarr కోసం Compose service

ఈ service ఇప్పటికే ఉన్న stack‌లోకి జతచేయబడుతుంది. ఇది విడుదలైన tag‌ను నిర్దిష్టంగా ఉపయోగిస్తుంది, web UI‌ను loopback‌కే publish చేస్తుంది, అలాగే మీ 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 line అర్థం “ఈ network ఇప్పటికే ఉంది, దానికి attach అవ్వాలి” అని. Prowlarr మరియు మీ torrent client వేర్వేరు Compose project‌ల నుంచి వస్తే దీన్ని ఉపయోగించండి. లేకపోతే రెండవ Compose file తనకంటూ వేరుచేయబడిన network‌ను సృష్టిస్తుంది. అప్పుడు Chaptarr, పేరు ద్వారా qbittorrent ను ఎప్పటికీ resolve చేయలేదు. నిజమైన పేరును docker network ls నుంచి పొందండి. మీ stack ఇప్పటికే ఒకే file‌లో ఉంటే, ఆ file‌కు chaptarr: service‌ను జతచేసి, మొత్తం networks: block‌ను తొలగించండి. విస్తృత layout గురించి Docker Compose కింద పూర్తి arr stack, naming rules గురించి Compose networks మరియు service names ఎలా resolve అవుతాయి చూడండి.

Config directoryని మీరే సృష్టించి, తరువాత దీన్ని start చేయండి.

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 start కావడంలో విఫలమై మళ్లీ ప్రయత్నిస్తోంది. దీనికి కారణం దాదాపు ఎల్లప్పుడూ config directoryలోనే ఉంటుంది. App port 8789పై listening ప్రారంభించిన తర్వాత log scrolling ఆగిపోతుంది.

PUID, PGID మరియు Docker rootగా సృష్టించే directory

మీరు PUID=99 మరియు PGID=100 విలువలను సెట్ చేయకపోతే, Chaptarr వాటికి డిఫాల్ట్‌గా PUID=99 మరియు PGID=100 ను ఉపయోగిస్తుంది. అవి unRAID విలువలు. సాధారణ Ubuntu VPSలో అవి ఉపయోగకరమైన ఏ userకు చెందవు. అందువల్ల మీ loginతో రాయలేని ownerతో files సృష్టించబడతాయి. మీ స్వంత విలువలను id -u మరియు id -g తో తెలుసుకుని, వాటిని fileలో నమోదు చేయండి.

అదే filesను ఉపయోగించే ప్రతి containerకు ఇదే జత అవసరం. Download client /srv/media/downloads లో రాస్తుంది. Chaptarr fileను /srv/media/audiobooks కు తరలిస్తుంది. Player అక్కడి నుంచే దాన్ని చదువుతుంది. Download client 1000:1000గా రాస్తే, Chaptarr 99:100గా నడుస్తుంది. అప్పుడు import విఫలమవుతుంది, ఎందుకంటే తనకు చెందినది కాని fileను Chaptarr delete చేయలదు లేదా తరలించలదు. కొత్త filesకు groupగా రాయగల అనుమతి ఉండేలా UMASK=002 చేస్తుంది. అనేక containers ఒకే media groupను పంచుకున్నప్పుడు ఇదే అవసరం. పూర్తి mappingను PUID మరియు PGID container userను host filesకు ఎలా map చేస్తాయో లో చూడండి.

README ఒక నిర్దిష్ట సమస్య గురించి హెచ్చరిస్తుంది. దాన్ని మళ్లీ గుర్తుచేయడం ఉపయోగకరం. docker compose up నడిపే సమయంలో ./config లేకపోతే, Docker దాన్ని స్వయంగా సృష్టిస్తుంది. దాని owner root:root అవుతుంది. అప్పుడు container UID 1000గా నడుస్తుంది. తన databaseలో రాయలేకపోవడంతో అది exit అయి మళ్లీ మళ్లీ restart అవుతుంది. పేర్లకు బదులుగా numeric ownersను చూపించే ls -ln ./config తో తనిఖీ చేయండి. రెండు zeros కనిపిస్తే owner root అని అర్థం. sudo chown -R 1000:1000 ./config తో దీన్ని సరిచేసి, containerను మళ్లీ start చేయండి.

ప్రత్యేక audiobook మరియు ebook volumes hardlinks ను ఎందుకు పనిచేయకుండా చేస్తాయి

పైన చూపిన layout లో /audiobooks, /ebooks మరియు /downloads ను ప్రత్యేక bind mounts గా అమర్చారు. ఇది project యొక్క స్వంత run command కు అనుగుణంగా ఉంటుంది. చదవడం సులభమే, కానీ దీనికి ఒక వాస్తవమైన పరిమితి ఉంది: hardlinks పనిచేయడం ఆగిపోతుంది.

hardlink అనేది disk పై ఉన్న అదే data కు రెండవ పేరు. ఇది అదనపు స్థలాన్ని ఉపయోగించదు మరియు వెంటనే సృష్టించబడుతుంది. అందుకే arr family copying కంటే దీనినే ప్రాధాన్యం ఇస్తుంది. hardlink ఒకే filesystem లో మాత్రమే పనిచేస్తుంది. Container లో ఇవి మూడు ప్రత్యేక mount points గా ఉంటాయి. అందువల్ల host paths ఒకే disk పై ఉన్నా kernel ఆ link ను నిరాకరిస్తుంది. దీన్ని మీరే పరీక్షించండి.

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

Invalid cross-device link తో ముగిసే error తో command విఫలమవుతుంది. ఇది mount points మధ్య link సృష్టించడాన్ని kernel నిరాకరిస్తోందని సూచిస్తుంది. Chaptarr file ను copy చేయడానికి fallback అవడానికి ఇదే ఖచ్చితమైన కారణం. Copy సరైనదే, కానీ నెమ్మదిగా ఉంటుంది. అలాగే torrent ను తొలగించే వరకు audiobook రెండుసార్లు ఉంటుంది. మీరు ఇంకా seeding చేస్తున్నప్పుడు దాన్ని తొలగించరు. తరువాత /srv/media/downloads/linktest ను తొలగించండి.

hardlinks కొనసాగాలంటే ఒక parent directory ను mount చేయండి:

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

తరువాత Chaptarr లోని root folders ను /data/audiobooks మరియు /data/ebooks గా సెట్ చేయండి. Download client కు కూడా అదే /srv/media:/data mount ఇవ్వండి, తద్వారా రెండు containers ఒకే identical path ను చూడగలవు. ముందుగా host side ఒకే filesystem పై ఉందని నిర్ధారించండి: రెండింటికీ Filesystem column లో df -h /srv/media/downloads /srv/media/audiobooks ఒకే value ను print చేయాలి. వేర్వేరు values అంటే వేర్వేరు disks అని అర్థం. ఏ mount layout అయినా వాటి మధ్య hardlink సృష్టించలేను. దీనికి మరియు named storage కు మధ్య trade-off ను media కోసం bind mounts మరియు named volumes లో వివరించారు.

వెబ్ UI ను బయటకు బహిర్గతం చేయకుండా యాక్సెస్ చేయడం

Port line ను 127.0.0.1 లో publish చేయడానికి కారణం ఉంది. ufw deny 8789 publish చేసిన Docker port ను రక్షించదు. Docker తన స్వంత NAT (network address translation) నియమాలను kernel, ufw నియమాలను చేరుకునే ముందే చేరుకునే chain లో రాస్తుంది. అందువల్ల మీ నియమాన్ని పరిశీలించేలోపే traffic forward అవుతుంది. ఈ ప్రవర్తన వల్ల తరచుగా సమస్యలు వస్తాయి. దీని గురించి publish చేసిన Docker port మీ ufw నియమాలను ఎందుకు పట్టించుకోదు లో వివరించారు. Loopback కు bind చేయడం ద్వారా ఈ సమస్య పూర్తిగా నివారించబడుతుంది.

మీ స్వంత machine నుంచి SSH tunnel ద్వారా UI ను యాక్సెస్ చేయండి:

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

ఆ tunnel ను నడుస్తూనే ఉంచి, మీ browser లో http://127.0.0.1:8789 తెరవండి. మొదటి run లో authentication ను configure చేయండి. ఆ తర్వాత మాత్రమే దాని ముందు TLS (transport layer security) కలిగిన reverse proxy ను ఉపయోగించడాన్ని పరిశీలించండి. ఇలాంటి tools లో మూడు లేదా నాలుగు వాటికి వేర్వేరు password లతో tunnel చేయాల్సి వచ్చినప్పుడు, proxy వెనుక Authentik వంటి self-hosted single sign-on server ఉంచడం మరింత క్రమబద్ధమైన పరిష్కారం. అప్పుడు ఒక login అన్ని apps కు సరిపోతుంది, ఒక revocation వాటన్నింటి access ను మూసివేస్తుంది.

ఇండెక్సర్‌లు మరియు download client ను అనుసంధానించండి

Chaptarr ప్రామాణిక arr indexer మరియు download client protocols కు మద్దతు ఇస్తుంది. అందువల్ల Prowlarr, Sonarr కోసం indexerలను జోడించిన విధంగానే Chaptarr లోకి పంపుతుంది. సాధారణ torrent మరియు usenet clients కు ప్రత్యేక నిర్వహణ అవసరం లేకుండా అనుసంధానం చేయవచ్చు.

ఒక setting వల్ల దాదాపు అందరికీ సమస్య వస్తుంది. Chaptarr download client host ను అడిగినప్పుడు localhost లేదా 127.0.0.1 నమోదు చేయవద్దు. Container లో ఆ address అదే container ను సూచిస్తుంది. అందువల్ల Chaptarr తన స్వంత port 8080 కు అనుసంధానించడానికి ప్రయత్నించి, connect కాలేదని తెలియజేస్తుంది. బదులుగా port 8080 తో container name qbittorrent ఉపయోగించండి. రెండు containers ఒకే network లో ఉన్నాయో లేదో docker network inspect arr తో నిర్ధారించండి. ఇది అనుసంధానమైన ప్రతి container పేరును చూపిస్తుంది.

మీ download client network_mode: "service:gluetun" ద్వారా VPN container లో నడుస్తుంటే, network లో దానికి స్వంత పేరు ఉండదు. కారణం, అది Gluetun యొక్క network namespace ను పంచుకుంటుంది. Gluetun అందుబాటులో ఉంచిన port పై దాన్ని gluetun గా address చేయండి. ఈ అమరికకు, దానికి సంబంధించిన routing కు Gluetun ద్వారా download client ను route చేయడం లో వివరాలు ఉన్నాయి.

Readarr విరామం: వలసకు వాస్తవంగా ఎంత ఖర్చవుతుంది

Chaptarr, Readarr metadata sources కు అనుకూలంగా ఉండదు. ఇది అనేక providers ద్వారా తన సొంత pipeline ఉపయోగించి titles, authors మరియు editions ను గుర్తిస్తుంది. అందువల్ల Readarr నిల్వ చేసిన identifiers ఇక్కడ ఉపయోగపడవు. Database import లేదు. నేరుగా అమలు చేయగల upgrade మార్గం కూడా లేదు.

ఇప్పటికే ఉన్న library విషయంలో files సురక్షితంగా ఉంటాయి, కానీ settings సురక్షితంగా ఉండవు. ఈ ప్రక్రియలో ఇప్పటికే disk పై ఉన్న దేనినీ మార్చదు. మీరు root folder ను జోడించి, library import ను అమలు చేస్తారు. తరువాత Chaptarr కనుగొన్న files ను తన సొంత metadata తో సరిపోల్చుతుంది. మీరు మాన్యువల్‌గా మళ్లీ నిర్మించాల్సినవి: quality profiles, naming format, indexer మరియు client settings, అలాగే Chaptarr తప్పుగా గుర్తించిన ప్రతి match. పెద్ద library కు మాన్యువల్ corrections అవసరం అవుతాయి. కాబట్టి పది నిమిషాలకన్నా ఒక సాయంత్రం సమయం కేటాయించండి.

ఈ క్రమంలో చేయండి. Readarr container ను ఆపండి, కానీ దాని config volume ను ఉంచండి. మీరు పాత settings ను చదివి, వాటిని మళ్లీ నమోదు చేయగలుగుతారు. ముందుగా Chaptarr ను ఒక చిన్న folder కు point చేసి, మొత్తం library ను import చేయడానికి ముందు matches ను పరిశీలించండి. మీకు ఫలితం సంతృప్తికరంగా అనిపించిన తరువాతే పాత container ను తొలగించండి.

మొత్తం library ను scan చేయడానికి ముందు తెలుసుకోవాల్సిన ఒక privacy విషయం ఉంది: metadata lookups api2.chaptarr.com కు వెళ్తాయి. ఆ requests లో provider IDs, search text, media type, tags మరియు filenames ఉండవచ్చని README పేర్కొంటుంది. అయితే full paths, user identity మరియు credentials అందులో ఉండవు. Filenames మీ server ను విడిచి వెళ్తాయి. Metadata service విషయంలో ఇది సాధారణమే. అయినప్పటికీ, ఈ ఎంపికను ఉద్దేశపూర్వకంగా నిర్ణయించాలి.

ఆడియోబుక్‌లను ప్లేయర్‌కు అందించండి

Chaptarr ఫైళ్లను క్రమబద్ధీకరిస్తుంది. వాటిని ప్లే చేయడం మరో ప్రోగ్రామ్ పని. సాధారణంగా దీనికి Audiobookshelf ఉపయోగిస్తారు, ఎందుకంటే ఇది పరికరాల మధ్య మీ వినే స్థానాన్ని భద్రపరుస్తుంది మరియు ఫోన్ యాప్‌లను అందిస్తుంది. దీని అధికారిక image ghcr.io/advplyr/audiobookshelf:latest. దీని documentation లోని Compose ఉదాహరణ host port 13378 ను container port 80 పైకి publish చేస్తుంది.

  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 లో /audiobooks ను library గా జోడించండి. తదుపరి scan తర్వాత కొత్త import కనిపిస్తుంది.

మీరు ఇప్పటికే Jellyfin నడుపుతున్నట్లయితే, ఆ folder ను అక్కడ library గా జోడించి ఫైళ్లను ప్లే చేయవచ్చు. అయితే ఒకే పొడవైన audiobook file కోసం resume ప్రవర్తన purpose-built audiobook server కంటే పరిమితంగా ఉంటుంది. ఆ భాగాన్ని setup చేయడం గురించి VPSపై Jellyfin ను media serverగా నడపడం లో వివరించబడింది. ebook భాగం కోసం /srv/media/ebooks ను reader application కు అందించండి. ఫైల్‌కు పేరు పెట్టి, సరైన స్థానంలో ఉంచిన తర్వాత Chaptarr పని పూర్తవుతుంది.

నిర్వహణ ప్రమాదం: లైసెన్స్, runtime, వేగంగా మారుతున్న tag

Chaptarr GPL-3.0 లైసెన్స్ కింద విడుదలవుతుంది. దీని copyright Chaptarr contributors కు చెందుతుంది; ఇందులో Servarr team నుంచి వచ్చిన కొన్ని భాగాలు ఉన్నాయి. అందువల్ల code openగానే ఉంటుంది. ఈ maintainer ప్రాజెక్ట్‌ను ఆపివేసినా, ఎవరైనా మళ్లీ fork చేయవచ్చు. ఇది .NET 10పై ఆధారపడుతుంది. ఆ runtime 2026 ఆగస్టు నాటికి ప్రస్తుత long term support release. కాబట్టి దీని ప్రాథమిక runtime నెలలపాటు మాత్రమే కాకుండా సంవత్సరాలపాటు support పొందుతుంది. వచ్చే సంవత్సరం కూడా ఈ project కొనసాగుతుందా అని అంచనా వేస్తున్నప్పుడు ఈ రెండు విషయాలు ముఖ్యమైనవి.

Version numbers వేగంగా మారుతున్నాయి. Releases pre-releases రూపంలో ప్రచురించబడుతున్నాయి. ఈ walkthrough వచ్చిన రోజునే 0.9.925 విడుదలైంది. ఖచ్చితమైన tag ను pin చేయండి. latest ఉపయోగిస్తే unattended docker compose pull ఒక వారంలో మిమ్మల్ని అనేక versions ముందుకు మార్చవచ్చు. ఇంత కొత్త fork releases మధ్య API ని మార్చే అవకాశం ఉంది. దాంతో దానిపై ఆధారపడి మీరు రాసిన script లేదా dashboard పనిచేయకపోవచ్చు.

ప్రతి 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

ఈ ప్రాజెక్ట్ సుమారు ఆరు నెలల కాలంలో మరియు పదకొండు వేలకుపైగా వినియోగదారులలో డేటా నష్టం జరిగిన సంఘటనలు ఏవీ నివేదించలేదని చెబుతోంది. అయినప్పటికీ backups ఉంచాలని, కోల్పోవడం భరించలేని library ను దీనికి అనుసంధానించవద్దని ఇప్పటికీ సూచిస్తోంది. ఈ రెండు విషయాలనూ తీవ్రంగా పరిగణించండి. config archive ను server వెలుపలికి copy చేయండి. రక్షించాల్సిన డేటా ఉన్న అదే disk పై backup ఉంటే అది backup కాదు. Chaptarr తన state ను /config కింద ఉన్న ఒకే SQLite file లో ఉంచుతుంది కాబట్టి ఆ ఒక్క tarball సరిపోతుంది. అయితే ప్రత్యేక database server పై ఉన్న డేటాను database dump చేయాలి. Postgres data మరియు uploaded files తో పాటు VPS పై Chatwoot ను self-hosting చేయడంలో backup దశ ఇదే విధంగా ఉంటుంది.

వైఫల్య పరిస్థితులు, మీరు చూడబోయే సందేశాలతో

Container loopలో పునఃప్రారంభమవుతుంది. docker compose ps, Restarting ను చూపిస్తుంది. ls -ln ./config ను అమలు చేయండి. Owner columns లోని రెండు సున్నాలు Docker ఆ directory ని root గా సృష్టించిందని, container user దాని database లో రాయలేకపోతున్నాడని సూచిస్తాయి. sudo chown -R 1000:1000 ./config ను అమలు చేయండి.

Imports ఎప్పటికీ పూర్తికావు మరియు files downloads లోనే ఉంటాయి. Chaptarr download ను చదవగలదు, కానీ library లోకి రాయలేకపోతుంది. ls -ln /srv/media/audiobooks ను మీ PUID మరియు PGID తో పోల్చండి. వేరే UID కు చెందిన directory, లేదా group కు చెందినప్పటికీ group write అనుమతి లేని directory, move ను ఆపుతుంది. కొత్త files కోసం UMASK=002 రెండవ పరిస్థితిని నివారిస్తుంది.

ప్రతి import తర్వాత disk usage రెట్టింపవుతుంది. Hardlink సృష్టించబడలేదు, అందువల్ల file copy చేయబడింది. Volumes section లోని ln test ను అమలు చేయండి. Invalid cross-device link తో ముగిసే error దీనిని నిర్ధారిస్తుంది. Single-parent mount దీనికి పరిష్కారం.

Download client connect కావడం లేదు. Host గా localhost ను నమోదు చేశారు. Container లో అది Chaptarr స్వయమే. Container name ను ఉపయోగించండి. docker network inspect arr రెండు containers ను జాబితా చేస్తుందో తనిఖీ చేయండి.

Compose service ను ప్రారంభించడానికి నిరాకరిస్తుంది. Bind for 127.0.0.1:8789 failed: port is already allocated అంటే ఆ port ను మరేదో ఉపయోగిస్తోందని అర్థం. sudo ss -lntp | grep 8789 తో దాన్ని కనుగొనండి.

Browser ఏదీ చూపించదు. Port ను 127.0.0.1 కు bind చేసినప్పుడు, internet ద్వారా మీ laptop connect కావడానికి ఏదీ ఉండదు. ఇదే ఉద్దేశించిన ప్రవర్తన. ముందుగా SSH tunnel ను తెరవండి.

FAQ

నా Readarr లైబ్రరీని Chaptarr కు మార్చవచ్చా?

దాన్ని నేరుగా import చేయడం సాధ్యం కాదు. Chaptarr, Readarr metadata sources కు అనుకూలంగా ఉండదు మరియు తన స్వంత provider pipeline ను ఉపయోగిస్తుంది. అందువల్ల Readarr లో భద్రపరిచిన identifiers కు ఇక్కడ ఉపయోగం ఉండదు. Database conversion కూడా లేదు. మీ disk లోని files కు ఎలాంటి మార్పు ఉండదు. అదే paths ను root folders గా జోడించి, library import ను అమలు చేయండి. తరువాత files ను Chaptarr స్వయంగా match చేయనివ్వండి. Quality profiles, naming format, indexer settings, అలాగే తప్పుగా జరిగిన matches ను మాన్యువల్‌గా సరిచేయాలి. కాబట్టి ప్రతిదీ import చేయడానికి ముందు ఒక చిన్న folder తో ప్రారంభించండి.

Chaptarr నా audiobook folder లో ఎందుకు రాయలేకపోతోంది?

Container user కు files పై ownership లేదు. ఈ variables unset గా ఉంటే Chaptarr PUID=99 మరియు PGID=100 విలువలకు fallback అవుతుంది. ఇవి unRAID విలువలు, సాధారణ Ubuntu VPS లో సరైనవి కావు. వాటిని మీ స్వంత id -u మరియు id -g విలువలకు సెట్ చేయండి. Download client లో కూడా అదే pair ను ఉపయోగించండి. కొత్త files group-writable గా ఉండేందుకు UMASK=002 ను సెట్ చేయండి. Library directory పై ownership ను ls -ln తో తనిఖీ చేయండి. ఇది names కు బదులుగా numbers ను చూపుతుంది. అందువల్ల మీరు వాటిని సరిపోల్చవచ్చు.

Import తర్వాత నా disk usage ఎందుకు రెండింతలు అయింది?

Chaptarr file ను hardlink చేయలేకపోవడంతో దాని copy ని సృష్టించింది. /downloads మరియు /audiobooks ను separate binds గా mount చేస్తే, container లో అవి separate mount points అవుతాయి. Mount points మధ్య hardlink ను kernel Invalid cross-device link తో తిరస్కరిస్తుంది. /srv/media:/data వంటి ఒక parent directory ను mount చేసి, app లో దాని లోపల /data/downloads మరియు /data/audiobooks ను ఉపయోగించండి. రెండు paths కూడా ఒకే host filesystem లో ఉండాలి. దీనిని df -h నిర్ధారిస్తుంది.

Chaptarr నా audiobooks ను play చేయగలదా?

లేదు. ఇది audiobooks ను కనుగొని, download చేసి, rename చేసి, files చేస్తుంది. Playback కోసం వేరే program అవసరం. Audiobookshelf సాధారణంగా దీనితో కలిపి ఉపయోగించే program. ఇది devices మధ్య మీ playback position ను గుర్తుంచుకుంటుంది. ఇందుకోసం అదే host audiobook path ను mount చేసి, అధికారిక image ghcr.io/advplyr/audiobookshelf:latest ను ఉపయోగించండి. Folder ను library గా జోడిస్తే Jellyfin కూడా files ను play చేస్తుంది. అయితే దీర్ఘమైన single-file audiobooks లో resume behaviour తక్కువగా నమ్మదగినదిగా ఉంటుంది.

నాకు ముఖ్యమైన library పై Chaptarr ను అమలు చేయడం సురక్షితమేనా?

ఇది కొత్త fork నుంచి వచ్చిన beta software. Project కూడా దీనిని స్పష్టంగా పేర్కొంటోంది. అదే సమయంలో, సుమారు ఆరు నెలల వ్యవధిలో data loss సంఘటనలు ఏవీ జరగలేదని, పదకొండు వేల మందికి పైగా users ఉన్నారని project నివేదిస్తోంది. GPL-3.0 licence code ను fork చేయడానికి అనుమతించడం ఒక భరోసా కలిగించే అంశం. అలాగే .NET 10 base, August 2026 నాటికి long term support runtime గా ఉంది. latest వంటి floating tag కు బదులుగా 0.9.925 వంటి exact image tag ను pin చేయండి. ప్రతి upgrade కు ముందు /config ను back up చేయండి. ఆ archive ను server వెలుపల భద్రపరచండి.