SSD Nodes Learn Hosting plans →
கல்வி வழிகாட்டிகள் Matt Connorஆல் Matt Connor · புதுப்பிக்கப்பட்டது 2026-10-24

VPS-ல் Paperless-ngx நிறுவுவது எப்படி: முழுமையான வழிகாட்டி

Docker Compose மூலம் VPS-ல் Paperless-ngx நிறுவும் முறையை அறியுங்கள். Postgres stack, OCR மொழிகள், PAPERLESS_URL மற்றும் HTTPS அமைப்புகளைச் சரியாகக் கட்டமைத்து ஆவணங்களை நிர்வகியுங்கள்.

நீங்கள் உருவாக்குவது என்ன

Paperless-ngx-ஐ ஒரு VPS-ல் நிறுவுவது, ஸ்கேன் செய்யப்பட்ட காகிதங்களின் கோப்புறையை தேடக்கூடிய ஆவணக் காப்பகமாக மாற்றுகிறது. நீங்கள் ஒரு PDF-ஐ குறிப்பிட்ட கோப்புறையில் (watched directory) இடும்போது, server அதில் OCR (optical character recognition) செய்து, உரையைப் பிரித்தெடுத்து, தேதியையும் தொடர்புடைய நபரையும் கணித்து, கோப்புகளை வகைப்படுத்துகிறது. இந்த நிறுவல் நான்கு services கொண்ட ஒரே Docker Compose கோப்பாகும். இதற்குப் பிந்தைய அனைத்தும் configuration சார்ந்தவை; இந்த வழிகாட்டி அதற்கே அதிக முக்கியத்துவம் அளிக்கிறது, ஏனெனில் அங்கேயேதான் நிறுவல்கள் பெரும்பாலும் தோல்வியடைகின்றன. இது ஒரு புகைப்பட நூலகம் அல்ல: விடுமுறைக்கால JPEG கோப்புகளுக்கு OCR மற்றும் correspondent guessing பயன்படாது, எனவே அவற்றை புகைப்படங்களுக்கென உருவாக்கப்பட்ட server-ல் சேமித்து, காகித ஆவணங்களுக்கு மட்டும் Paperless-ஐப் பயன்படுத்தவும். வீடியோக்களுக்கும் இதே விதிதான்: நீங்கள் சேமித்து வைத்துள்ள திரைப்படங்கள் ஒரு media server-க்கு உரியவை; அங்கு 90-களின் வீடியோ கடை போல வடிவமைக்கப்பட்ட Jellyfin front end போன்றவற்றை பயன்படுத்தினால், தேடுவதற்குப் பதிலாக உலாவுவது எளிதாக இருக்கும்.

Paperless-ngx என்பது அசல் Paperless திட்டத்தின் தற்போதைய சமூகப் பதிப்பாகும் (community fork). இது இலவசமானது, self-hosted முறையில் இயங்கக்கூடியது, மேலும் உங்கள் ஆவணங்களை வட்டில் சாதாரண கோப்புகளாகச் சேமிக்கிறது, எனவே உங்கள் ஆவணக் காப்பகத்தை நீங்கள் எப்போதும் அணுக முடியும். இதை உங்கள் வீட்டில் உள்ள கணினிக்கு பதிலாக VPS-ல் இயக்குவதன் மூலம், உங்கள் வீட்டு router-ல் port திறக்காமலேயே எங்கிருந்தும் ஸ்கேன் செய்த ஆவணங்களை அணுக முடியும். இது காகித ஆவணங்கள் அல்லாத பிற கோப்புகளுக்கான தனிப்பட்ட Nextcloud instance-உடன் சிறப்பாகச் செயல்படும். இதே தர்க்கம் உங்கள் ஸ்கேனர் இணைக்கப்பட்டுள்ள கணினிக்கும் பொருந்தும், ஏனெனில் அதே VPS-ல் உள்ள RustDesk relay மூலம், உங்கள் வீட்டு router-ல் துளை இடாமலேயே அந்த கணினியை எங்கிருந்தும் இயக்க முடியும்.

இந்த stack உண்மையில் எவற்றை இயக்குகிறது

அதிகாரப்பூர்வ compose கோப்பு நான்கு containers-ஐத் தொடங்குகிறது. ஒவ்வொன்றும் என்ன செய்கிறது என்பதைத் தெரிந்துகொள்வது, logs-ஐப் புரிந்துகொள்ள உதவும்.

  • webserver: paperless-ngx image. இது web interface, API, input folder-ஐக் கண்காணிக்கும் consumer, மற்றும் OCR பணிகளைச் செய்யும் Celery task workers ஆகியவற்றை இயக்குகிறது.
  • db: PostgreSQL. இது metadata, tags, correspondents மற்றும் full-text search index அட்டவணைகளைச் சேமிக்கிறது. இது உங்கள் PDF கோப்புகளைச் சேமிப்பதில்லை.
  • broker: Valkey, இது Redis-உடன் இணக்கமான key-value store ஆகும். இது web process மற்றும் workers-க்கு இடையிலான task queue-ஆகச் செயல்படுகிறது.
  • gotenberg மற்றும் tika: இவை விருப்பத்தேர்வுக்குரியவை, -tika compose வகைகளில் மட்டுமே இருக்கும். இவை Office ஆவணங்களை (.docx, .xlsx, .odt) PDF-ஆக மாற்றுகின்றன, அப்போதுதான் paperless அவற்றை index செய்ய முடியும்.

அக்டோபர் 2026 நிலவரப்படி, postgres compose கோப்பு docker.io/library/postgres:18 மற்றும் docker.io/valkey/valkey:9-alpine ஆகியவற்றை pin செய்கிறது, மேலும் app-ஐ ghcr.io/paperless-ngx/paperless-ngx:latest-லிருந்து பதிவிறக்கம் செய்கிறது.

முன்நிபந்தனைகள்

  • sudo அணுகல் கொண்ட Ubuntu 24.04 KVM VPS மற்றும் ஏற்கனவே நிறுவப்பட்ட Docker Compose plugin. இது உங்களுக்குப் புதியது என்றால், VPS-க்கான Docker Compose அடிப்படைகள் பகுதியில் தொடங்கிவிட்டு மீண்டும் வரவும்.
  • உங்கள் VPS-ஐச் சுட்டிக்காட்டும் A record கொண்ட ஒரு domain name. நீங்கள் குறிப்பிட்ட hostname-ஐத் தவிர மற்ற பெயர்களில் வரும் HTTPS sign-in கோரிக்கைகளை Paperless ஏற்காது, எனவே இதை ஆரம்பத்திலேயே சரிபார்ப்பது அவசியம்.
  • நினைவகம் (Memory) மிக முக்கியமான காரணி. PostgreSQL, Valkey, Granian web server மற்றும் Tesseract OCR worker ஆகிய அனைத்தும் ஒரே நேரத்தில் இயங்க, குறைந்த பயன்பாட்டிற்கு 2 GB போதுமானது. நீங்கள் நூற்றுக்கணக்கான ஆவணங்களை இறக்குமதி செய்யத் திட்டமிட்டால் 4 GB நினைவகத்தை ஒதுக்கவும். ஏனெனில், பெரிய multi-page PDF கோப்புகளை OCR செய்யும்போது ஏற்படும் நினைவகப் பயன்பாட்டு அதிகரிப்பால், kernel-ன் out-of-memory killer உங்கள் worker-ஐ நிறுத்திவிடக்கூடும்.
  • வட்டு (Disk): உங்கள் ஆவணங்கள் இரண்டு பிரதிகளாகச் சேமிக்கப்படும் (அசல் கோப்பு மற்றும் OCR செய்யப்பட்ட archive PDF), எனவே உங்கள் ஆவணங்களின் அளவைப் போல இரண்டு மடங்கு வட்டு இடவசதியைத் திட்டமிடுங்கள்.

அதிகாரப்பூர்வ compose கோப்புகளைப் பெறுதல்

இதற்கென ஒரு interactive installer உள்ளது:

bash -c "$(curl --location --silent --show-error https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/install-paperless-ngx.sh)"

இது உங்களிடம் கேள்விகளைக் கேட்டு, உங்களுக்காகக் கோப்புகளை உருவாக்கும். நீங்களாகவே கைகளால் செய்வது நான்கு கட்டளைகளை உள்ளடக்கியது; இது உங்கள் server-ல் உள்ள அனைத்தும் எங்குள்ளது என்பதைத் தெளிவாகப் புரிந்துகொள்ள உதவும், பராமரிப்புப் பணிகளுக்கு இதுவே சிறந்தது.

mkdir -p ~/paperless && cd ~/paperless
curl -fsSL -o docker-compose.yml https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.postgres.yml
curl -fsSL -o docker-compose.env https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.env
curl -fsSL -o .env https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/.env

இதன் பல்வேறு வகைகள் ஒரே directory-ல் உள்ளன: docker-compose.sqlite.yml, docker-compose.mariadb.yml, மற்றும் ஒவ்வொன்றிலும் ஒரு -tika பதிப்பு. புதிய நிறுவலுக்கு (install) postgres-ஐத் தேர்ந்தெடுக்கவும். சில நூறு ஆவணங்களுக்கு SQLite போதுமானது, ஆனால் PostgreSQL-ஐ விட இதில் full-text search index மெதுவாகச் செயல்படும்.

.env கோப்பில் ஒரே ஒரு வரி மட்டுமே இருக்கும், அது COMPOSE_PROJECT_NAME=paperless. அந்தப் பெயரே ஒவ்வொரு container மற்றும் volume-க்கும் prefix-ஆக அமையும், எனவே அதை நீக்கிவிட்டு, ஏன் docker compose down -v உங்கள் தரவைக் கண்டறிய முடியவில்லை என்று குழப்பமடைய வேண்டாம்.

முதல் முறை தொடங்குவதற்கு முன் docker-compose.env-ஐ உள்ளமைக்கவும்

இரண்டு அமைப்புகள் விருப்பத்திற்குரியவை அல்ல. திட்ட ஆவணத்தில் உள்ள கட்டளையைப் பயன்படுத்தி secret key-ஐ உருவாக்கவும்:

python3 -c "import secrets; print(secrets.token_urlsafe(64))"

பின்பு docker-compose.env-ஐத் திருத்தவும்:

PAPERLESS_SECRET_KEY=<the long string you just generated>
PAPERLESS_URL=https://paperless.example.com
PAPERLESS_TIME_ZONE=Europe/Berlin
PAPERLESS_OCR_LANGUAGE=deu+eng
USERMAP_UID=1000
USERMAP_GID=1000

PAPERLESS_SECRET_KEY என்பது change-me என்ற நேரடி மதிப்பைக் கொண்டுள்ளது. இது session tokens-ஐ கையொப்பமிடுகிறது, மேலும் தற்போதைய releases அந்த placeholder-ஐ அமைக்கப்படாததாகக் கருதுகின்றன: key விடுபட்டாலோ, காலியாக இருந்தாலோ அல்லது இன்னும் change-me என்றே இருந்தாலோ paperless தொடங்க மறுத்துவிடும், எனவே நீங்கள் அதை மாற்றும் வரை stack இயங்காது. முதல் முறை தொடங்குவதற்கு முன்பே இதை அமைக்கவும், ஏனெனில் இதைத் தாமதமாக மாற்றினால் அனைத்து பயனர்களும் வெளியேற்றப்படுவார்கள் (log out).

PAPERLESS_URL என்பது உங்கள் நேரத்தை மிச்சப்படுத்தும் ஒரு அமைப்பாகும். Paperless ஒரு Django application ஆகும், மேலும் Django ஆனது Host header மற்றும் sign-in படிவத்தில் browser தெரிவிக்கும் origin ஆகிய இரண்டையும் சரிபார்க்கிறது. PAPERLESS_URL-ஐ அமைத்தால், அது உங்கள் முகவரியை ALLOWED_HOSTS, CORS_ALLOWED_HOSTS மற்றும் CSRF_TRUSTED_ORIGINS ஆகியவற்றில் தானாகவே சேர்த்துவிடும். இதை காலியாக விட்டுவிட்டு, ஒரு domain-ஐ அந்த server-க்குச் சுட்டிக்காட்டினால், sign-in பக்கம் இன்னும் ஏற்றப்படும், ஏனெனில் PAPERLESS_ALLOWED_HOSTS இயல்பாக * என்று இருக்கும். ஆனால், HTTPS வழியாக அதைச் சமர்ப்பிக்கும்போது CSRF verification failed. Request aborted. பிழை ஏற்படும், ஏனெனில் உங்கள் domain ஒரு நம்பகமான origin அல்ல. இதை இறுதியில் slash (/) இல்லாமல் மற்றும் path இல்லாமல் எழுதவும்.

USERMAP_UID மற்றும் USERMAP_GID ஆகியவை container இயங்கும் பயனர் கணக்கை அமைக்கின்றன. அவற்றை உங்கள் சொந்தக் கணக்குடன் பொருத்தவும், இதை id -u மற்றும் id -g மூலம் சரிபார்க்கலாம். இவை பொருந்தவில்லை என்றால், நீங்கள் consume folder-க்குள் நகலெடுக்கும் கோப்புகளை consumer-ஆல் படிக்க முடியாது, மேலும் import செய்வதற்குப் பதிலாக log-ல் permission error காட்டப்படும்.

Stack-ஐத் தொடங்கி முதல் பயனரை உருவாக்குதல்

docker compose pull
docker compose up -d
docker compose run --rm webserver createsuperuser
docker compose logs -f webserver

createsuperuser பயனர் பெயர், மின்னஞ்சல் மற்றும் கடவுச்சொல்லைக் கேட்கும். இதில் default login கிடையாது. இந்த நிலையைத் தவிர்த்தால், web interface-ஐ முதலில் திறப்பவர் superuser-ஐ உருவாக்கக் கேட்கும். port 8000 இணையத்திற்குத் திறந்திருக்கும்போது, அது நீங்களாக இல்லாமல் இருக்கலாம். எனவே, shell மூலமாகவே கணக்கை உடனடியாக உருவாக்கவும். browser-ல் முயற்சிக்கும் முன், server port 8000-ல் listening நிலையில் இருப்பதாக log-ல் வரும் வரை காத்திருக்கவும். முதல்முறை தொடங்கும் போது database migrations நடைபெறும், இதற்கு ஒன்று அல்லது இரண்டு நிமிடங்கள் ஆகலாம்.

Domain-ஐ இணைக்கும் முன் local-ஆகச் சரிபார்க்கவும்:

curl -I http://127.0.0.1:8000

302-லிருந்து /accounts/login/-க்கு redirect ஆவது, stack சரியாக இயங்குவதைக் குறிக்கிறது.

இதற்கு முன்னால் HTTPS-ஐ அமைக்கவும்

வழக்கமான compose கோப்பு 8000:8000-ஐ வெளியிடுகிறது, இது அனைத்து interface-களிலும் இணைகிறது. பொதுவான VPS ஒன்றில் இதை இயக்கினால், முகவரியைக் கண்டறியும் எவருக்கும் உங்கள் முழு ஆவணக் காப்பகமும் plain HTTP வழியாகக் கிடைக்கும். எனவே, loopback-ல் மட்டும் இணைக்க port வரியை மாற்றவும்:

    ports:
      - "127.0.0.1:8000:8000"

பின்பு, ஒரு reverse proxy-ல் TLS (transport layer security)-ஐ முடித்துவிட்டு, 127.0.0.1:8000-க்கு forward செய்யவும். இந்த server-ல் இது மட்டுமே இயங்கும் application என்றால், ACME (automatic certificate management environment) client கொண்ட எந்த proxy-யும் போதுமானது. ஒரே certificate அமைப்பின் கீழ் பல containers-ஐ இயக்கினால், பல Docker Compose பயன்பாடுகளுக்கான Traefik reverse proxy முறையைப் பின்பற்றவும் மற்றும் webserver service-ஐ எந்த port-ம் வெளியிடாமல் proxy network-உடன் இணைக்கவும்.

நீங்கள் எந்த proxy-யைப் பயன்படுத்தினாலும், login form-ன் origin சரிபார்ப்பில்தான் HTTPS அமைப்புகள் பெரும்பாலும் தோல்வியடையும். நீங்கள் PAPERLESS_PROXY_SSL_HEADER-ஐ அமைக்காவிட்டால் Paperless X-Forwarded-Proto-ஐப் புறக்கணிக்கும் (இது இயல்பாகவே முடக்கப்பட்டிருக்கும்). இதனால் Django ஒவ்வொரு proxied கோரிக்கையையும் plain HTTP-ஆகக் கருதும், மேலும் உங்கள் browser அனுப்பும் https:// origin, அது நம்பகமான பட்டியலில் இருந்தால் மட்டுமே அனுமதிக்கப்படும். PAPERLESS_URL-ஐ நீங்கள் browser-ல் தட்டச்சு செய்யும் சரியான https:// முகவரிக்கு அமைப்பதுதான் அதை அந்தப் பட்டியலில் சேர்க்கும். இல்லையெனில், சரியாகத் தெரியும் பக்கத்தில் CSRF verification failed. Request aborted. பிழையைப் பெறுவீர்கள்.

மேலும், proxy-ன் upload அளவு வரம்பை அதிகரிக்கவும். 1 MB-க்கு மேல் கோப்புகளை அனுமதிக்காத proxy வழியாக 40 MB ஸ்கேன் செய்யப்பட்ட கோப்பை அனுப்பினால், அது Paperless-க்குச் செல்லும் முன்பே நிராகரிக்கப்படும், மேலும் browser ஒரு பொதுவான upload தோல்வியைக் காட்டும்.

consume directory எவ்வாறு செயல்படுகிறது

Compose file, ./consume-ஐ compose directory-யிலிருந்து container-க்குள் bind-mount செய்கிறது. நீங்கள் அங்கு வைக்கும் எந்தவொரு கோப்பும் இறக்குமதி செய்யப்பட்டு, அந்த கோப்புறையிலிருந்து நீக்கப்படும்; ஏனெனில், அந்த கோப்பு இப்போது paperless நிர்வாகத்தின் கீழ் உள்ள media volume-ல் சேமிக்கப்பட்டுவிடும்.

cp ~/scan-2026-07-14.pdf ~/paperless/consume/
docker compose logs -f webserver

Consumer கோப்பின் பெயரை எடுத்துக்கொண்டு, OCR-ஐ இயக்கி, ஆவணம் சேர்க்கப்பட்டதை உறுதிப்படுத்தும் வரியுடன் முடிப்பதை நீங்கள் பார்க்க வேண்டும். ஒரு பக்க ஸ்கேன் செய்வதற்கு இந்த முழு சுழற்சியும் சில வினாடிகள் ஆகும், நீண்ட ஆவணங்களுக்கு ஒரு நிமிடம் அல்லது அதற்கு மேல் ஆகலாம்.

கோப்புகள் கண்டறியப்படும் விதத்தை இரண்டு அமைப்புகள் மாற்றுகின்றன. PAPERLESS_CONSUMER_RECURSIVE=true, paperless-ஐ subfolders-க்குள் தேட வைக்கிறது, மேலும் PAPERLESS_CONSUMER_SUBDIRS_AS_TAGS=true ஒவ்வொரு subfolder பெயரையும் ஒரு tag-ஆக மாற்றுகிறது. எனவே, ஒரு கோப்பை consume/invoices/2026/-க்குள் போட்டால், அது invoices மற்றும் 2026 என tag செய்யப்படும். இது நீங்கள் உருவாக்கும் மிக எளிமையான கோப்பு முறைமை (filing system) ஆகும்.

கண்டறிதல் என்பது மற்றொரு பகுதி. இயல்பாக PAPERLESS_CONSUMER_POLLING_INTERVAL என்பது 0 என இருக்கும், அதாவது paperless native filesystem அறிவிப்புகளைப் பயன்படுத்துகிறது, இவை உடனடியாகச் செயல்படும். அந்த அறிவிப்புகள் network filesystem-ல் நம்பகமானவை அல்ல. உங்கள் consume folder ஒரு NFS அல்லது SMB share-ஆக இருந்து, ஒரு network scanner அதில் கோப்புகளை எழுதினால், அவை கண்டறியப்படாமல் இருக்கலாம். இதைச் சரிசெய்ய, interval-ஐ ஒரு நேர்மறை வினாடி எண்ணாக அமைக்க வேண்டும்; அப்போதுதான் paperless அந்த கோப்புறையைத் தொடர்ந்து ஸ்கேன் செய்யும்.

OCR மொழிகள் மற்றும் அவற்றின் செலவு

PAPERLESS_OCR_LANGUAGE ஒரு மூன்று எழுத்து Tesseract குறியீட்டை எடுத்துக்கொள்கிறது, இயல்பாக eng பயன்படுத்தப்படுகிறது. deu+eng என்பதில் உள்ளது போல, பிளஸ் (+) குறியீட்டைப் பயன்படுத்தி மொழிகளை இணைக்கலாம். Tesseract ஒவ்வொரு பக்கத்திலும் பட்டியலிடப்பட்ட அனைத்து மொழிகளுக்கும் வேலை செய்யும், எனவே ஒவ்வொரு கூடுதல் மொழியும் ஒவ்வொரு ஸ்கேனுக்கும் CPU நேரத்தை அதிகரிக்கும். ஒரு பகிரப்பட்ட vCPU VPS-ல், இது ஒரு ஸ்கேன் பத்து வினாடிகளில் முடிவதற்கும் ஒரு நிமிடத்தில் முடிவதற்கும் உள்ள வித்தியாசத்தை ஏற்படுத்தும். உங்கள் ஆவணங்கள் எந்த மொழிகளில் எழுதப்பட்டுள்ளனவோ, அந்த மொழிகளை மட்டும் பட்டியலிடுங்கள்.

இந்த image-ல் English, German, Italian, Spanish மற்றும் French ஆகிய மொழிகள் உள்ளன. மற்ற மொழிகளுக்கு, PAPERLESS_OCR_LANGUAGES என்பதில் மொழியை இடைவெளியால் பிரிக்கப்பட்ட பட்டியலாகச் சேர்க்கவும், உதாரணமாக PAPERLESS_OCR_LANGUAGES=tur ces, பின்னர் restart செய்யவும். இந்த container தொடங்கும் போது Tesseract தரவுப் பொதிகளை (data packs) பதிவிறக்கம் செய்யும், எனவே அந்த மாற்றத்திற்குப் பிறகு நடக்கும் முதல் boot மெதுவாக இருக்கும்.

Database மற்றும் media-வை பேக்அப் செய்தல்

PostgreSQL இயங்கிக்கொண்டிருக்கும்போது Docker volumes-ஐ நகலெடுப்பது, சரியாக restore ஆகாத பேக்அப்-ஐ உருவாக்கலாம். Paperless சொந்தமாக ஒரு exporter-ஐ வழங்குகிறது; இது ஆவணங்களையும், அனைத்து metadata-வையும் கொண்ட ஒரு JSON manifest-ஐ ./export bind mount-ல் எழுதும்:

docker compose exec -T webserver document_exporter ../export --delete --no-progress-bar

--delete தற்போதைய ஆவணத்துடன் பொருந்தாத ஏற்றுமதி செய்யப்பட்ட கோப்புகளை நீக்குகிறது, எனவே அந்த கோப்புறை தொடர்ந்து வளர்ந்து கொண்டிருக்காமல் ஒரு mirror-ஆகவே இருக்கும். --no-progress-bar இது cron மூலம் இயங்கும்போது வெளியீட்டைத் தெளிவாக வைத்திருக்கும், மேலும் -T இது cron-க்கு இல்லாத terminal-ஐ Compose கேட்பதைத் தடுக்கும்.

புதிய stack-ல் அதே கோப்புறையைப் பயன்படுத்தி document_importer மூலம் restore செய்யலாம், அதாவது இந்த ஏற்றுமதி கோப்புறையை மட்டும் நீங்கள் பாதுகாப்பாக வைத்திருந்தால் போதுமானது. இதை ஒரு கால அட்டவணையின்படி உங்கள் VPS-லிருந்து encrypted, deduplicated restic backups மூலம் offsite-க்கு அனுப்பவும். restic முழுமையற்ற archive-ஐ எடுக்காமல் இருக்க, முதலில் export-ஐ இயக்கவும்.

export/manifest.json கோப்பு உள்ளதா என்பதையும், கோப்புகளின் எண்ணிக்கை interface-ல் உள்ள உங்கள் ஆவணங்களின் எண்ணிக்கையுடன் பொருந்துகிறதா என்பதையும் சரிபார்த்து பேக்அப்-ஐ உறுதிப்படுத்தவும். நீங்கள் ஒருமுறை கூட சரிபார்க்காத பேக்அப், பேக்அப் ஆகாது. அமைதியாகத் தோல்வியடையும் nightly export இன்னும் மோசமானது, எனவே cron job-ன் exit status-ஐ உங்கள் சொந்த ntfy server-க்கு அனுப்பவும். அப்போதுதான் அது பழுதடைந்தால், நீங்கள் restore செய்ய வேண்டிய நாளுக்கு முன்பே அந்த வாரமே உங்களுக்குத் தெரிந்துவிடும்.

FAQ

எனது domain-ஐ point செய்த பிறகு, ஏன் ஒவ்வொரு பக்கமும் "Bad Request (400)" என்று காட்டுகிறது?

வழக்கமான கோப்புகளைப் பயன்படுத்தும்போது இது நிகழக்கூடாது, ஏனெனில் PAPERLESS_ALLOWED_HOSTS இயல்பாகவே * என அமைக்கப்பட்டிருக்கும். container log-ல் DisallowedHost உடன் ஒரு 400 பிழை இருந்தால், PAPERLESS_ALLOWED_HOSTS-ல் உங்கள் domain விடுபட்டுள்ளது என்று அர்த்தம். docker-compose.env கோப்பில் PAPERLESS_URL=https://paperless.example.com-ஐ, இறுதியில் slash இல்லாமல் அமைக்கவும்; அப்போது paperless அந்த hostname-ஐ பட்டியலில் சேர்த்துக்கொள்ளும். அல்லது PAPERLESS_ALLOWED_HOSTS வரியை நீக்கிவிடவும். பிறகு, container-ஐ மீண்டும் உருவாக்க docker compose up -d கட்டளையை இயக்கவும். env கோப்பை மட்டும் திருத்தினால் போதாது, ஏனெனில் இயங்கிக்கொண்டிருக்கும் container அது தொடங்கப்பட்டபோது இருந்த environment-ஐயே வைத்திருக்கும்.

நான் consume folder-ல் ஒரு PDF-ஐப் போட்டேன், ஆனால் எதுவும் நடக்கவில்லை. என்ன தவறு?

முதலில் docker compose logs webserver-ஐச் சரிபார்க்கவும். permission பிழை இருந்தால், USERMAP_UID மற்றும் USERMAP_GID ஆகியவை கோப்பின் உரிமையாளர் கணக்குடன் பொருந்தவில்லை என்று அர்த்தம். அவற்றைச் சரிசெய்துவிட்டு container-ஐ மீண்டும் உருவாக்கவும். log-ல் எந்த வரியும் இல்லை என்றால், file event வந்து சேரவில்லை என்று பொருள். network shares-ல் native filesystem அறிவிப்புகள் நம்பகத்தன்மையற்றவை என்பதால் இது நிகழ்கிறது. PAPERLESS_CONSUMER_POLLING_INTERVAL-ஐ 30 போன்ற மதிப்பிற்கு மாற்றினால், paperless ஒவ்வொரு 30 வினாடிக்கும் அந்த folder-ஐ scan செய்யும்.

PostgreSQL-க்கு பதிலாக SQLite-ஐப் பயன்படுத்தி paperless-ngx-ஐ இயக்க முடியுமா?

ஆம், docker-compose.sqlite.yml ஆதரிக்கப்படுகிறது. இது குறைந்த memory-யையே எடுத்துக்கொள்ளும், எனவே சிறிய VPS-க்கு இது ஏற்றது. உங்கள் ஆவணங்களின் எண்ணிக்கை ஆயிரக்கணக்கில் அதிகரிக்கும்போது, full-text search மற்றும் bulk tag edits ஆகியவற்றின் வேகம் குறையும். பிற்காலத்தில் PostgreSQL-க்கு மாற வேண்டுமென்றால், தரவுகளை export மற்றும் import செய்ய வேண்டியிருக்கும். எனவே, உங்கள் ஆவணக் காப்பகம் தொடர்ந்து வளரும் என்று எதிர்பார்த்தால், இப்போதே PostgreSQL-ஐத் தேர்வு செய்யவும்.

ஸ்கேன் செய்யப்பட்ட ஆவணக் காப்பகத்திற்கு எவ்வளவு disk இடம் தேவைப்படும்?

உங்கள் source கோப்புகளின் அளவைப் போல சுமார் இரண்டு மடங்கு இடம் தேவைப்படும். Paperless அசல் கோப்பை மாற்றாமல் அப்படியே வைத்திருக்கும்; அதனுடன் தேடக்கூடிய text layer கொண்ட இரண்டாவது OCR செய்யப்பட்ட PDF-ஐயும், சிறிய thumbnails-களையும் சேமிக்கும். வெறும் text கொண்ட 200 KB ஸ்கேன் சிறியதாகவே இருக்கும். நீண்ட ஒப்பந்தத்தின் 30 MB வண்ண ஸ்கேன் சுமார் 60 MB-ஐ எடுத்துக்கொள்ளும். நீங்கள் export directory-யையும் அதே disk-ல் வைத்திருந்தால், ஒரே ஆவணம் disk-ல் மூன்று முறை சேமிக்கப்படும்.

எனக்கு Tika மற்றும் Gotenberg containers தேவையா?

உங்கள் PDF-களுடன் சேர்த்து Word, Excel அல்லது OpenDocument கோப்புகளையும் index செய்ய விரும்பினால் மட்டுமே இவை தேவை. அவை அந்த கோப்பு வடிவங்களை PDF-ஆக மாற்றும், அப்போதுதான் paperless-ஆல் அவற்றை OCR செய்து தேட முடியும். இவை மேலும் இரண்டு containers-ஐ இயக்குவதுடன், சில நூறு megabytes memory-யையும் எடுத்துக்கொள்ளும். எனவே, நீங்கள் சேமிக்கும் அனைத்தும் ஏற்கனவே PDF அல்லது படங்களாக இருந்தால், சிறிய server-ல் இவற்றைத் தவிர்த்துவிடலாம்.

இந்தக் கட்டுரை பயனுள்ளதாக இருந்ததா?

#paperless-ngx#documents#self-hosting#docker#ocr