Arama Yap Mesaj Gönder
Biz Sizi Arayalım
+90
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro
X

Lütfen Ülke (Bölge) Seçiniz

Türkiye (Türkçe)Türkiye (Türkçe) Almanya (German)Almanya (German) Worldwide (English)Worldwide (English)
X

Lütfen Para Birimi Seçiniz

Türk Lirası $ US Dollar Euro

Bize Ulaşın

Konum Halkalı merkez mahallesi fatih cd ozgur apt no 46 , Küçükçekmece , İstanbul , 34303 , TR

Paperless-ngx Kurulumu: Türkçe OCR ile Belge ve Fatura Arşivi

Paperless-ngx’i PostgreSQL, Redis ve Türkçe OCR ile Ubuntu’da kurun; tarayıcı klasörü, e-posta tüketimi, belge kuralları, Nginx SSL, exporter yedeği, geri yükleme ve bütünlük kontrolünü tamamlayın.

Paperless-ngx Kurulumu: Türkçe OCR ile Belge ve Fatura Arşivi
Bu rehberin sonunda ne çalışacak?

Paperless-ngx’i PostgreSQL, Redis ve Türkçe OCR ile Ubuntu’da kurun; tarayıcı klasörü, e-posta tüketimi, belge kuralları, Nginx SSL, exporter yedeği, geri yükleme ve bütünlük kontrolünü tamamlayın. Komutlar kopyalanabilir biçimde verilmiştir; örnek alan adları ve parolalar çalıştırılmadan önce kendi değerlerinizle değiştirilmelidir.

Kurulum öncesi mimari ve gereksinimler

  • Ubuntu 24.04, Docker Compose
  • 4 vCPU ve 8 GB RAM önerilen başlangıç; yoğun OCR için daha fazla CPU
  • documents.example.com DNS kaydı
  • Orijinal belgeler ve exporter yedeği için ayrı depolama

DNS ve port planı

  • 80/443 TCP: HTTPS
  • 8000/TCP: yalnız reverse proxy
  • 5432/6379: yalnız Docker ağı

Uygulamalı kurulum adımları

1. Kurulum dosyaları
mkdir -p /opt/paperless-ngx
cd /opt/paperless-ngx
curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.postgres.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/paperless-ngx/paperless-ngx/main/docker/compose/docker-compose.env -o docker-compose.env
2. Temel ayarlar
PAPERLESS_URL=https://documents.example.com
PAPERLESS_TIME_ZONE=Europe/Istanbul
PAPERLESS_OCR_LANGUAGE=tur+eng+deu
PAPERLESS_OCR_LANGUAGES=tur deu
PAPERLESS_SECRET_KEY=GUCLU_RASTGELE_SECRET
PAPERLESS_ADMIN_USER=ekaadmin
PAPERLESS_ADMIN_PASSWORD=ILK_GIRISTEN_SONRA_DEGISTIR
PAPERLESS_REDIS=redis://broker:6379
PAPERLESS_DBHOST=db
3. Dizinler
mkdir -p consume export data media
sudo chown -R 1000:1000 consume export data media
sudo docker compose --env-file docker-compose.env config
sudo docker compose --env-file docker-compose.env up -d
4. Sağlık ve OCR
sudo docker compose ps
sudo docker compose logs --tail 150 webserver
sudo docker compose exec webserver tesseract --list-langs
curl -I http://127.0.0.1:8000
5. Tam exporter yedeği
sudo docker compose exec -T webserver document_exporter ../export --compare-checksums --delete --no-progress-bar
find export -type f | wc -l
sha256sum export/manifest.json
6. Geri yükleme
sudo docker compose down
sudo docker compose up -d db broker
sudo docker compose run --rm webserver document_importer ../export --no-progress-bar
sudo docker compose up -d
7. Bütünlük denetimi
sudo docker compose exec webserver document_sanity_checker
sudo docker compose exec webserver document_index reindex --if-needed
sudo docker compose exec webserver document_create_classifier
8. Nginx reverse proxy
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx
sudo tee /etc/nginx/sites-available/documents.example.com > /dev/null <<'NGINX'
server {
    listen 80;
    listen [::]:80;
    server_name documents.example.com;
    client_max_body_size 10G;
    proxy_read_timeout 3600;
    proxy_send_timeout 3600;
    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}
NGINX
sudo ln -s /etc/nginx/sites-available/documents.example.com /etc/nginx/sites-enabled/documents.example.com
sudo nginx -t
sudo systemctl reload nginx
9. Let’s Encrypt SSL ve yenileme testi
sudo certbot --nginx -d documents.example.com --redirect --agree-tos --no-eff-email -m [email protected]
sudo certbot renew --dry-run
curl -I https://documents.example.com
openssl s_client -connect documents.example.com:443 -servername documents.example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates

Üretime geçmeden önce bilinmesi gerekenler

Üretim notu
Belge exporter; belgeleri, thumbnail’leri, metadata ve veritabanı içeriğini taşınabilir biçimde çıkarır fakat API tokenlarını içermez. Geri yüklemeden sonra tokenlar yeniden üretilmelidir.
Üretim notu
Exporter ile importer sürümlerini eşleştirmek en güvenli yöntemdir. Yeni major sürüme geçmeden önce mevcut sürüm etiketi, Compose dosyası ve export birlikte saklanmalıdır.
Üretim notu
OCR dili yalnız arayüz dili değildir. tur+eng+deu seçimi işlem süresini artırabilir; gerçek belge setinde doğruluk ve CPU maliyeti ölçülmelidir.
Üretim notu
consume klasörüne ağ tarayıcısı yazıyorsa SMB kullanıcısına yalnız gerekli yazma yetkisi verin; klasörü internete veya anonim paylaşıma açmayın.

Yaygın hatalar ve kök nedenleri

Belirti / SymptomKök neden ve çözüm / Root cause and fix
Belge consume edilmiyorHost klasörünün container içinde doğru /usr/src/paperless/consume yoluna mount edildiği ve UID/GID izinleri kontrol edilir.
Türkçe karakterler okunmuyortur dil paketinin container içinde listelendiği ve PAPERLESS_OCR_LANGUAGE değerinin yeniden oluşturulan container’a uygulandığı doğrulanır.
Duplicate documentDosya checksum’u, daha önce tüketilen belge ve ASN/filename eşleşmesi incelenir; orijinal silinmez.
Import farklı sürümde bozuluyorBoş hedef kurulum exporter ile aynı Paperless sürümüne alınır, sonra kontrollü şekilde güncellenir.

Kurulum sonrası doğrulama listesi

  • Tüm container veya servisler healthy/running durumda
  • Alan adı HTTPS üzerinden geçerli sertifika ile açılıyor
  • Yalnız gerekli portlar dışarıdan erişilebilir
  • Yönetici hesabında güçlü parola ve MFA etkin
  • Yedek dosyasının checksum değeri kaydedildi
  • Ayrı ortamda en az bir geri yükleme testi tamamlandı
  • Loglarda tekrarlayan kritik hata bulunmuyor
  • Yeniden başlatma sonrası servisler otomatik açılıyor

Resmî teknik kaynaklar

İlgili EKA Sunucu rehberleri

Sık sorulan sorular

Bu kurulum üretimde kullanılabilir mi?

Evet; fakat örnek değerler değiştirilmeden, erişim sınırları uygulanmadan ve geri yükleme testi yapılmadan üretime alınmamalıdır.

Minimum sunucu yeterli olur mu?

Minimum değer yalnız kurulumun açılması içindir. Eş zamanlı kullanıcı, veri büyümesi ve arka plan işleri ölçülerek kaynak payı bırakılmalıdır.

Cloudflare kullanılabilir mi?

Evet. SSL modu Full (strict), doğru origin sertifikası ve WebSocket/gerçek IP başlıkları uygulamanın gereksinimine göre ayarlanmalıdır.

Güncelleme otomatik yapılmalı mı?

Major sürümler otomatik güncellenmemelidir. Sürüm notu, veritabanı migration bilgisi, yedek ve geri dönüş imajı kontrol edilmelidir.

Hangi yedekler alınmalı?

Veritabanı, yüklenen dosyalar, volume verileri, yapılandırma, şifreleme anahtarları ve kullanılan sürüm etiketi aynı geri dönüş setinde tutulmalıdır.

VPS mi GPU sunucu mu?

Web paneli ve standart iş yükleri için NVMe VPS yeterli olabilir. Model inference, OCR hızlandırma veya video transcoding varsa uygun GPU gerekir.

Kurulum için bize ulaşın

Paperless-ngx’i PostgreSQL, Redis ve Türkçe OCR ile Ubuntu’da kurun; tarayıcı klasörü, e-posta tüketimi, belge kuralları, Nginx SSL, exporter yedeği, geri yükleme ve bütünlük kontrolünü tamamlayın.

VPS paketlerini inceleyinKurulum için bize ulaşın
Top