நிறுவுதல்

HolyArrs-ஐ Docker-இல் இயக்கி, உங்கள் browser-இல் திறக்கவும். சில நிமிடங்கள் ஆகும்.

தொடங்கும் முன்

• Docker மற்றும் Docker Compose உள்ள ஒரு கணினி.
• உங்கள் media அடைவுகள், அல்லது அவற்றை உருவாக்க ஓர் இடம். நகலெடுப்புக்குப் பதிலாக உடனடி நகர்த்தல் வேண்டுமென்றால் முதலில் அடைவுகள் படிக்கவும்.
• NAS, Unraid அல்லது Synology-இல் என்றால் NAS, Synology மற்றும் Unraid பார்க்கவும். Docker இல்லாமல் என்றால் Portable காப்பகங்கள் பார்க்கவும்.

படிகள்

1. கட்டமைவு அடைவுக்காக உள்ளூர் வட்டில் ஓர் அடைவை உருவாக்கவும், எடுத்துக்காட்டாக /srv/holyarrs/config. பிணையப் பகிர்வில் வேண்டாம். Docker Desktop-இல் அதற்குப் பதிலாகப் பெயரிடப்பட்ட volume பயன்படுத்தவும். Docker Desktop பார்க்கவும்.

2. உங்கள் media அடைவுகளுக்கு உரிமையான பயனரையும் குழுவையும் கண்டுபிடிக்கவும்:

   id youruser
   # uid=1000(youruser) gid=1000(youruser)

   uid-ஐ PUID ஆகவும், gid-ஐ PGID ஆகவும் பயன்படுத்தவும்.

3. இதை docker-compose.yml ஆகச் சேமித்து, பாதைகளை மாற்றவும்:

   name: holyarrs
   services:
     holyarrs:
       image: holyarrs/holyarrs:latest
       container_name: holyarrs
       environment:
         - PUID=1000
         - PGID=1000
         - TZ=Etc/UTC
       volumes:
         - /srv/holyarrs/config:/config
         - /path/to/movies:/movies #optional
         - /path/to/tv:/tv #optional
         - /path/to/music:/music #optional
         - /path/to/downloads:/downloads #optional
       ports:
         - 6262:6262
       restart: unless-stopped

4. தொடங்கவும்:

   docker compose up -d
   docker compose ps

   HolyArrs பதிலளித்ததும் container healthy என்று காட்டும்.

5. http://your-server:6262 திறந்து உடனே உரிமையாளர் கணக்கை உருவாக்கவும். இயல்புநிலை கடவுச்சொல் இல்லை. நீங்கள் உருவாக்கும் வரை, HolyArrs-ஐ முதலில் திறப்பவர் உரிமையாளர் ஆகிவிடுவார்.

6. அடுத்து திறக்கும் அமைவைப் பின்பற்றவும். முதல் இயக்கம் பார்க்கவும்.

எச்சரிக்கை

இயல்புநிலை கடவுச்சொல் இல்லை. புதிய HolyArrs-ஐ முதலில் திறப்பவர் உரிமையாளர் ஆகிவிடுவார். இப்போதே கணக்கை உருவாக்கவும்.

docker run விரும்பினால்:

docker run -d \
  --name=holyarrs \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 6262:6262 \
  -v /srv/holyarrs/config:/config \
  -v /path/to/movies:/movies `#optional`   -v /path/to/tv:/tv `#optional`   -v /path/to/music:/music `#optional`   -v /path/to/downloads:/downloads `#optional` \
  --restart unless-stopped \
  holyarrs/holyarrs:latest

Image tag

Tag	என்ன கிடைக்கும்
latest	புதிய பதிப்பு
1.0.0 (எந்தப் பதிப்பும்)	அதே பதிப்பு, ஒருபோதும் மாறாது

அமைப்புகள் விளக்கம்

Port-களும் அடைவுகளும்

அமைப்பு	என்ன செய்கிறது
-p 6262:6262	web பயன்பாடு.
-v /config	தரவுத்தளங்கள், அமைப்புகள், முதன்மை விசை, backup-களும் log-களும். உள்ளூர் வட்டில் மட்டும்.
-v /movies	விருப்பத்துக்குரியது. திரைப்பட நூலக அடைவு.
-v /tv	விருப்பத்துக்குரியது. தொடர் நூலக அடைவு.
-v /music	விருப்பத்துக்குரியது. இசை நூலக அடைவு.
-v /downloads	விருப்பத்துக்குரியது. பதிவிறக்கியின் பதிவிறக்க அடைவு. Media அடைவுகள் பார்க்கவும்.
--read-only=true	விருப்பத்துக்குரியது. படிக்க மட்டும் root கோப்பு முறைமை பார்க்கவும்.
--user=1000:1000	விருப்பத்துக்குரியது. நிலையான பயனராகத் தொடங்குதல் பார்க்கவும்.

சூழல் மாறிகள்

மாறி	என்ன செய்கிறது
PUID, PGID	HolyArrs இயங்கும் பயனரும் குழுவும். விட்டுவிட்டால் 1000 மற்றும் 1000.
TZ	நேர மண்டலம், எடுத்துக்காட்டாக Europe/Amsterdam.
UMASK	விருப்பத்துக்குரியது. புதிய கோப்புகள் எந்த அனுமதி bit-களை விட்டுவிடும் என்பது, எடுத்துக்காட்டாக 022 அல்லது 002.
HOLYARRS_SAVE_PATH	விருப்பத்துக்குரியது. பதிவிறக்கியின் சேமிப்பு அடைவு, பதிவிறக்கி பார்க்கும் விதத்தில்.
HOLYARRS_ALLOWED_HOSTS	விருப்பத்துக்குரியது. HolyArrs-ஐ அடைய மக்கள் பயன்படுத்தும் கூடுதல் host பெயர்கள், காற்புள்ளியால் பிரிக்கப்பட்டவை.
HOLYARRS_TRUSTED_PROXIES	விருப்பத்துக்குரியது. உங்கள் reverse proxy-இன் முகவரி அல்லது வலையமைப்பு.
HOLYARRS_URL_BASE	விருப்பத்துக்குரியது. HolyArrs-ஐ ஒரு பாதையின் கீழ் வழங்கும். URL base மற்றும் reverse proxy-கள் பார்க்கவும்.
HOLYARRS_MASTER_KEY_FILE	விருப்பத்துக்குரியது. முதன்மை விசையைத் தனிக் கோப்பிலிருந்து படிக்கும்.

எந்த மாறியும் ஒரு கோப்பிலிருந்து வரலாம். பெயருக்கு முன் FILE__ சேர்த்து, கோப்பின் பாதையை மதிப்பாகக் கொடுக்கவும்:

environment:
  - FILE__HOLYARRS_ALLOWED_HOSTS=/run/secrets/holyarrs_hosts

கோப்பின் முடிவில் உள்ள ஒரு புதிய வரி நீக்கப்படும். இது PUID, PGID, UMASK மற்றும் TZ-க்கும் வேலை செய்யும். கோப்பு இல்லையென்றால், HolyArrs நின்றுவிடும், log-இல் அந்த மாறியின் பெயரைக் குறிப்பிடும். மதிப்பை ஒருபோதும் அச்சிடாது.

Image

Image-இல் HolyArrs மட்டுமே உள்ளது, வேறு எதுவும் இல்லை. அதில் shell இல்லை, அதனால் சுற்றிப் பார்க்க docker exec செய்ய முடியாது. அதற்குப் பதிலாக docker logs holyarrs மூலம் log-ஐப் படிக்கவும், அல்லது கட்டமைவு அடைவில் logs/holyarrs.log திறக்கவும்.

HolyArrs-இன் சொந்தக் கட்டளைகள் இன்னும் docker exec வழியாக வேலை செய்யும்:

docker exec holyarrs /holyarrs doctor
docker exec -i holyarrs /holyarrs reset-owner
docker exec holyarrs /holyarrs restore --pre-update

Image-கள் amd64, 64-bit ARM மற்றும் 32-bit ARM-க்காக உருவாக்கப்படுகின்றன. சுமார் 2.5 GiB அல்லது அதற்குக் குறைவான நினைவகம் உள்ள கணினியில், HolyArrs குறைந்த நினைவக முறை-ஐத் தானாகவே இயக்கும். முதல் log வரி அதைச் சொல்லும்.

பயனரும் குழுவும்

Container root ஆகத் தொடங்குவது தன்னை அமைத்துக்கொள்ள மட்டுமே. தேவைப்படும்போது கட்டமைவு அடைவை PUID:PGID-க்குக் கொடுக்கும், பிறகு நிரந்தரமாக அந்தப் பயனருக்கு மாறும். முதல் log வரி பயனர், குழு, umask ஆகியவற்றைக் காட்டும்.

உங்கள் media அல்லது பதிவிறக்க அடைவுகளின் உரிமையாளரை HolyArrs ஒருபோதும் மாற்றாது. PUID பயனருக்கு அவற்றில் எழுத்து அணுகலை நீங்களே கொடுக்கவும். படிக்க மட்டும் அணுகல் போதாது, ஏனெனில் HolyArrs அடைவுகளை உருவாக்கி கோப்புகளை நகர்த்துகிறது.

சில சேமிப்பகங்களில் உரிமையாளரை மாற்ற முடியாது, எடுத்துக்காட்டாக root squash உள்ள NFS, SMB அல்லது படிக்க மட்டும் mount. அப்போது HolyArrs எச்சரிக்கையைப் பதிவு செய்து தொடரும். கட்டமைவு அடைவை PUID:PGID-க்கு எழுதத்தக்கதாகக் கையால் அமைக்கவும்.

பயனர் மாற, CHOWN, DAC_OVERRIDE, SETUID மற்றும் SETGID capability-கள் தேவை. Docker அவற்றை இயல்பாகக் கொடுக்கும். அவற்றை நீக்கினால், HolyArrs ஒரு செய்தியுடன் நின்றுவிடும். அது root-க்குத் திரும்பாது. உண்மையிலேயே root ஆக இயக்க, PUID=0 மற்றும் PGID=0 அமைக்கவும்.

group_add: இலிருந்து வரும் கூடுதல் குழுக்கள், HolyArrs பயனர் மாறும்போது அப்படியே இருக்கும்.

UMASK புதிய கோப்புகளை மட்டுமே பாதிக்கும். நீங்கள் எழுதி மற்றவர்கள் படிக்கும் 022-ஐ வைத்துக்கொள்ள, அதை விட்டுவிடவும். ஒரு குழுவும் எழுத வேண்டுமென்றால் 002 பயன்படுத்தவும்.

Media அடைவுகள்

நீங்கள் பயன்படுத்தும் அடைவுகளை மட்டும் mount செய்யவும்: /movies, /tv மற்றும் /music நூலக அடைவுகளாக, /downloads பதிவிறக்க அடைவாக.

Hardlink (கடின இணைப்பு) குறிப்பு: நீங்கள் தனித்தனியாக mount செய்யும் ஒவ்வோர் அடைவும் container-இல் ஒரு தனி mount ஆகும், ஒரு கோப்பை mount-களுக்கு இடையே hardlink செய்ய முடியாது, அதனால் இறக்குமதிகள் முழு நகல்களாக ஆகும். Hardlink வேண்டுமென்றால், அந்த நான்கு விருப்ப mount-களுக்குப் பதிலாக, பதிவிறக்க அடைவுகளையும் நூலக அடைவுகளையும் உள்ளே கொண்ட ஒரு பகிரப்பட்ட மேல் அடைவை mount செய்யலாம், பதிவிறக்கிக்கும் அதே mount-ஐ அதே பாதையில் கொடுக்கவும். மேல் அடைவு ஒரே கோப்பு முறைமையாகவும் இருக்க வேண்டும். அதன் கீழ் உள்ள தனித்தனி NAS பகிர்வுகள் அல்லது dataset-கள் இன்னும் நகலெடுக்கும். HolyArrs நகலெடுக்க வேண்டியிருக்கும்போது Settings > Library folders (அமைப்புகள் > நூலக அடைவுகள்) எச்சரிக்கும்.

HOLYARRS_SAVE_PATH ஒவ்வொரு பதிவிறக்கத்துடனும் பதிவிறக்கிக்கு அனுப்பப்படும், அதனால் அது பதிவிறக்கி சேமிக்கும் இடத்தையும் மாற்றும். பதிவிறக்கியின் சொந்த அமைப்பை வைத்துக்கொள்ள அதை விட்டுவிடவும். அதை விட்டுவிட்டால், அதிலிருந்து கையால் இறக்குமதி செய்ய, Settings > Library folders > Extra import folders (கூடுதல் இறக்குமதி அடைவுகள்) என்பதன் கீழ் பதிவிறக்க அடைவைச் சேர்க்கவும்.

முதன்மை விசையைப் பாதுகாத்தல்

HolyArrs சேமித்த கடவுச்சொற்கள், விசைகள் மற்றும் token-களை முதன்மை விசையால் குறியாக்கம் செய்கிறது. முதல் தொடக்கம் /config/holyarrs.key-ஐ உருவாக்கும்.

Backup-களில் இந்த விசை இருக்காது. ஒரு நகலை வேறு இடத்தில் வைக்கவும். எளிய வழி: உரிமையாளராக, Settings > Backups (அமைப்புகள் > Backup-கள்) திறந்து Download key kit (key kit-ஐ பதிவிறக்கு) தேர்ந்தெடுக்கவும். அதை மீண்டும் வைக்க, கோப்பிற்கு holyarrs.key என்று பெயரிட்டு, HolyArrs நின்றிருக்கும்போது கட்டமைவு அடைவில் வைக்கவும். வேறு விசையுடன் மீட்டமைப்பு மறுக்கப்படும். பெயரிடப்பட்ட volume-இல் திறக்க அடைவு இல்லை: அதை docker cp holyarrs.key hx:/config/ மூலம் உள்ளே நகலெடுக்கவும், Docker Desktop-இல் உள்ளது போல. புதிய கணினிக்கு மாறுகிறீர்களா? முதலில் விசையை மீண்டும் வைக்கவும், பிறகு backup-ஐ மீட்டமைக்கவும். Backup-கள் பார்க்கவும்.

விசையைத் தனிப் படிக்க-மட்டும் கோப்பிலும் வைக்கலாம்:

environment:
  - HOLYARRS_MASTER_KEY_FILE=/keys/holyarrs.key
volumes:
  - /srv/holyarrs/keys:/keys:ro

கோப்பு இருக்க வேண்டும், 32 raw byte-கள், 64 hex இலக்கங்கள் அல்லது 32 byte-களுக்கான base64 கொண்டிருக்க வேண்டும். PUID பயனரால் அதைப் படிக்க முடிய வேண்டும்.

மறுதொடக்கமும் மீட்டமைப்பும்

மறுதொடக்கக் கொள்கையை வைத்திருக்கவும். மீட்டமைப்பு சரிபார்க்கப்பட்டுத் தயார்படுத்தப்படும், பிறகு HolyArrs குறியீடு 75-உடன் வெளியேறும், அப்போது Docker அதை மீண்டும் தொடங்கி அதைப் பயன்படுத்தும். unless-stopped அதைக் கையாளும்.

உள்ளூர் build-ஐப் புதுப்பிக்க, mount-களைத் தொடாமல் மீண்டும் build செய்து மீண்டும் உருவாக்கவும்:

docker build --file deploy/Dockerfile --tag holyarrs:local .
docker compose up -d --force-recreate

புதுப்பிப்பின்போது /config-ஐ ஒருபோதும் நீக்க வேண்டாம். புதுப்பிப்புகள் மற்றும் Backup-கள் பார்க்கவும்.

Host பெயர்களும் reverse proxy-களும்

IP முகவரிகளும் localhost-உம் உடனே வேலை செய்யும். முதல் அமைவின்போது நீங்கள் பயன்படுத்தும் tower.local போன்ற வீட்டுப் பெயர் உங்களுக்காகச் சேமிக்கப்படும். மற்ற பெயர்களை Settings > Sign-in and security (அமைப்புகள் > உள்நுழைவும் பாதுகாப்பும்) இல் Allowed host names (அனுமதிக்கப்பட்ட host பெயர்கள்) என்பதன் கீழ் சேர்க்கவும், அல்லது HOLYARRS_ALLOWED_HOSTS-இல் சேர்க்கவும்.

Reverse proxy X-Forwarded-For சேர்க்கும்போது, proxy-இன் முகவரி அல்லது வலையமைப்பை மட்டுமே HOLYARRS_TRUSTED_PROXIES-இல் வைக்கவும். அது இல்லாமல், single sign-on, உண்மையான வாடிக்கையாளர் முகவரிகள் மற்றும் Secure cookie வேலை செய்யாது, proxy-க்குப் பின்னால் இருக்கும் எல்லோரும் ஒரே உள்நுழைவு வரம்பைப் பகிர்வார்கள். சேர்க்க வேண்டிய proxy முகவரியை log குறிப்பிடும். முன்னால் வேறு proxy இருந்தால், எடுத்துக்காட்டாக Cloudflare, அதன் வரம்புகளையும் சேர்க்கவும்.

nginx-இல், இரண்டு header-களையும் அனுப்பவும்:

proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

இரண்டும் ஒத்துப்போகவில்லை என்றால், HolyArrs வருபவரை உங்கள் வலையமைப்புக்கு வெளியே உள்ளவராகக் கருதும்.

பாதுகாப்பு அடிப்படைகள்

• உங்கள் router-இல் port 6262-ஐ forward செய்ய வேண்டாம். Tailscale போன்ற VPN-ஐப் பயன்படுத்தவும், அல்லது HTTPS உள்ள reverse proxy-ஐப் பயன்படுத்தவும்.
• முதல் தொடக்கத்துக்குப் பிறகு உடனே உரிமையாளர் கணக்கை உருவாக்கவும்.
• முதன்மை விசையின் நகலைக் கட்டமைவு அடைவிலிருந்து தள்ளி வைக்கவும்.
• Image-ஐப் புதுப்பித்து வைக்கவும்.

சிறப்பு அமைவுகள்

Docker Desktop (Windows மற்றும் Mac)

Docker Desktop host அடைவுகளை ஒரு அடுக்கு வழியாகப் பகிர்கிறது, அங்கே தரவுத்தளக் கோப்புப் பூட்டுகள் பாதுகாப்பானவை அல்ல. அங்குள்ள /config-ஐ HolyArrs மறுத்து, port 6262-இல் தீர்வைக் காட்டும். /config-க்குப் பெயரிடப்பட்ட volume பயன்படுத்தவும். Media அடைவுகள் host அடைவுகளாகவே இருக்கலாம்.

name: holyarrs
services:
  holyarrs:
    image: holyarrs/holyarrs:latest
    container_name: holyarrs
    environment:
      - TZ=Etc/UTC
    volumes:
      - holyarrs-config:/config
      - C:/Media/movies:/movies
    ports:
      - 6262:6262
    restart: unless-stopped

volumes:
  holyarrs-config:

பழைய கட்டமைவு அடைவை volume-க்குள் நகர்த்த, HolyArrs-ஐ நிறுத்தி இதை இயக்கவும்:

docker create --name hx -v holyarrs-config:/config holyarrs/holyarrs:latest
docker cp C:\old\config\. hx:/config/
docker rm hx

Backup-களை வெளியே நகலெடுக்க: docker cp holyarrs:/config/backups .

Mac-இல், உங்கள் அடைவில் கோப்புப் பூட்டுகள் வேலை செய்கின்றன என்று நீங்கள் சரிபார்த்திருந்தால், எப்படியும் தொடங்க HOLYARRS_ALLOW_DESKTOP_FOLDER=1 அமைக்கவும். ஒவ்வொரு தொடக்கத்திலும் HolyArrs எச்சரிக்கும். இது பிணையப் பகிர்வுகளுக்கான மறுப்பை ஒருபோதும் நீக்காது.

படிக்க மட்டும் root கோப்பு முறைமை

/config மற்றும் /tmp மட்டுமே எழுதத்தக்கதாக இருந்தால் போதும்:

services:
  holyarrs:
    read_only: true
    tmpfs:
      - /tmp

PUID, PGID மற்றும் UMASK இன்னும் வேலை செய்யும்.

நிலையான பயனராகத் தொடங்குதல்

services:
  holyarrs:
    user: "1000:1000"

அப்போது HolyArrs எந்த உரிமையாளரையும் மாற்றாது, அதனால் கட்டமைவு அடைவு ஏற்கெனவே அந்தப் பயனருக்கு எழுதத்தக்கதாக இருக்க வேண்டும். PUID மற்றும் PGID புறக்கணிக்கப்படும், log அதைச் சொல்லும். இது Kubernetes runAsUser-க்கும் பொருந்தும்.

Rootless Docker மற்றும் Podman

Rootless முறையில், container-க்குள் root என்பது உங்கள் சொந்தப் பயனர், மற்ற id-கள் host-இல் உயர் எண்களுக்கு இணையும். PUID=1000 உடன், கட்டமைவு அடைவு host-இல் யாரோ அந்நியரின் உரிமையில் முடியும்.

நீங்கள் இயக்குவது	docker info அல்லது podman info காட்டுவது	பயன்படுத்த வேண்டியது
சாதாரண Docker	rootless இல்லை	வழக்கம்போல PUID மற்றும் PGID
Rootless Docker	Security Options-இன் கீழ் rootless	தேர்வு 1
Rootless Podman	rootless: true	தேர்வு 1 அல்லது 2

தேர்வு 1. PUID=0 மற்றும் PGID=0 அமைக்கவும். இது rootless முறையில் மட்டுமே பாதுகாப்பானது. சாதாரண Docker-இலோ NAS-இலோ இதை ஒருபோதும் செய்ய வேண்டாம்.

தேர்வு 2. keep-id உடன் Podman, ~/.config/containers/systemd/holyarrs.container-இல் ஒரு Quadlet ஆக:

[Container]
Image=holyarrs/holyarrs:latest
UserNS=keep-id
User=%U:%G
Volume=%h/holyarrs/config:/config:Z
PublishPort=6262:6262
HealthCmd=["/holyarrs","-healthcheck"]
HealthInterval=30s

[Service]
Restart=always

[Install]
WantedBy=default.target

அல்லது ஒரே கட்டளையாக:

podman run -d --name holyarrs --userns=keep-id --user "$(id -u):$(id -g)" -v ~/holyarrs/config:/config:Z -p 6262:6262 --health-cmd '["/holyarrs","-healthcheck"]' --health-interval 30s --restart always holyarrs/holyarrs:latest

• :Z SELinux கணினிகளுக்கானது. பதிவிறக்கி பகிரும் அடைவுகளில் :z பயன்படுத்தவும். பிணையப் பகிர்வில் (NFS அல்லது SMB) இரண்டில் எதுவும் வேண்டாம்: அதன் label-ஐ மாற்ற முடியாது, container தொடங்காது.
• Health check-ஐப் பட்டியலாகக் கொடுக்கவும். Image-இல் shell இல்லை.
• மறுதொடக்கக் கொள்கையை always ஆக வைக்கவும். Podman-இன் reboot-க்குப் பின் தொடங்கும் service always container-களை மட்டுமே தொடங்கும்.
• உள்நுழையாமலே reboot-க்குப் பின் தொடங்க, loginctl enable-linger $USER ஒருமுறை இயக்கவும். பிறகு Quadlet கோப்பைப் பயன்படுத்தவும், அல்லது podman run-க்கு systemctl --user enable podman-restart.service இயக்கவும்.

அடைவு ஏற்கெனவே உயர் id-க்குச் சொந்தமாக இருந்தால், முதலில் container-ஐ நிறுத்தவும், பிறகு:

• Rootless Podman: podman unshare chown -R 0:0 ~/holyarrs/config (தேர்வு 1) அல்லது podman unshare chown -R 1000:1000 ~/holyarrs/config.
• Rootless Docker: rootlesskit chown -R 0:0 ~/holyarrs/config, rootless daemon-க்குள் nsenter வழியாக இயக்கவும் (nsenter -U --preserve-credentials -n -m -t $(cat $XDG_RUNTIME_DIR/docker.pid)).

உங்கள் சொந்த image-ஐ build செய்தல்

HolyArrs checkout-இலிருந்து:

docker build --file deploy/Dockerfile --tag holyarrs:local .

பிறகு holyarrs:local-ஐ image ஆகப் பயன்படுத்தவும்.

சிக்கல் தீர்வு

முதலில் doctor-ஐ இயக்கவும். அது கட்டமைவு, அடைவுகள், வலையமைப்பு மற்றும் கடிகாரத்தைச் சரிபார்த்து, ஒவ்வொரு சிக்கலையும் எப்படித் தீர்ப்பது என்று சொல்லும்.

• Container இயங்கும்போது: docker exec holyarrs /holyarrs doctor
• Container மீண்டும் மீண்டும் மறுதொடக்கம் ஆகும்போது: docker compose run --rm holyarrs doctor

Log மற்றும் ஆதரவுத் தொகுப்புக்கு சிக்கல் தீர்வு பார்க்கவும்.

நீங்கள் பார்ப்பது	செய்ய வேண்டியது
Config folder is on a shared or network folder	உள்ளூர் வட்டைப் பயன்படுத்தவும், அல்லது Docker Desktop-இல் பெயரிடப்பட்ட volume. Unraid-இல் /mnt/<pool>/appdata/holyarrs பயன்படுத்தவும்.
Config folder is in memory	/config-ஐ ஒரு வட்டில் வைக்கவும். Unraid-இல், pool பாதை இருக்கிறதா எனப் பார்க்கவும். சோதனைக் கணினிக்கு, HOLYARRS_CONFIG_IN_MEMORY=yes அதை அனுமதிக்கும்.
Config folder cannot be written	:ro-ஐ நீக்கவும், PUID:PGID அந்த அடைவுக்கு உரிமையானவையா எனப் பார்க்கவும்.
Disk is full	/config உள்ள வட்டில் இடத்தை விடுவித்து, பிறகு மறுதொடக்கம் செய்யவும்.
/config is not mapped	கீழே பார்க்கவும்.
Cannot switch user	அந்த நான்கு capability-களையும் மீண்டும் சேர்க்கவும், அல்லது user: "<uid>:<gid>" பயன்படுத்தவும்.
PUID/PGID does not exist inside this container	id-கள் பொருத்தப்பட்ட வரம்புக்கு வெளியே உள்ளன. Rootless Docker மற்றும் Podman பார்க்கவும்.
A FILE__ variable cannot be read	பாதையையும், கோப்பு mount செய்யப்பட்டுள்ளதா என்பதையும் சரிபார்க்கவும்.
Permission denied	எல்லா அடைவுகளிலும் PUID, PGID மற்றும் எழுத்து அணுகலைச் சரிபார்க்கவும்.
Unknown host name	HolyArrs-ஐ IP மூலம் திறந்து, Allowed host names என்பதன் கீழ் பெயரைச் சேர்க்கவும்.
Imports are copied	ஒரு பகிரப்பட்ட அடைவை mount செய்யவும். Media அடைவுகள் பார்க்கவும்.
Master key does not match	அந்தத் தரவுத்தளங்களுக்குரிய விசையை மீண்டும் வைக்கவும்.
Restore staged but the app stays down	மறுதொடக்கக் கொள்கையைச் சேர்த்து container-ஐத் தொடங்கவும்.

/config-ஐ பொருத்த மறந்துவிட்டீர்களா?

HolyArrs இன்னும் தொடங்கும், ஆனால் எல்லா இடங்களிலும் எச்சரிக்கும். Container நீக்கப்பட்டால் எல்லாமே இழக்கப்படும். முதலில் அதைச் சேமிக்கவும்:

docker stop holyarrs
docker cp holyarrs:/config ./holyarrs-config

பிறகு ./holyarrs-config:/config-ஐ (அல்லது பெயரிடப்பட்ட volume-ஐ) பொருத்தி, container-ஐ மீண்டும் உருவாக்கவும். Docker Desktop-இல் (Windows மற்றும் Mac), host அடைவு அல்ல, பெயரிடப்பட்ட volume பயன்படுத்தவும், தரவை Docker Desktop-இல் காட்டியபடி உள்ளே நகலெடுக்கவும். பழைய அமைவு இன்னும் பெயரில்லா volume-இல் இருக்கலாம். அவற்றை docker volume ls மூலம் பட்டியலிடவும்.

தொடர்புடையவை

• அடைவுகள்
• முதல் இயக்கம்
• NAS, Synology மற்றும் Unraid
• புதுப்பிப்புகள்