VPS Üzerinde Paperless-ngx’i Kendiniz Barındırma (Tam Kılavuz)

Paperless-ngx, bir belge yönetim sistemi olup, VPS (Virtual Private Server) üzerinde kendiniz barındırmak iş akışınızı kolaylaştırabilir ve veri gizliliğinizi artırabilir. Bu kılavuz, Docker kullanarak VPS üzerinde Paperless-ngx’i kurma adımlarını anlatacak ve hem geliştiriciler hem de homelab meraklıları için erişilebilir hale getirecektir.

Paperless-ngx Nedir?

Paperless-ngx, belgelerinizi kolayca taramanıza, yüklemenize ve yönetmenize olanak tanıyan açık kaynaklı bir uygulamadır. Paperless ruhunu temel alan bu modern varyant, geliştirilmiş özellikler ve daha kullanıcı dostu bir arayüz sunar. Kendi kendine barındırılarak, belgeleriniz üzerinde kontrol sizde olur ve üçüncü taraf hizmetlere bağlı kalmadan yönetebilirsiniz.

VPS Sağlayıcısı Seçimi

Başlamadan önce, bir VPS sağlayıcısı seçmeniz gerekir. Aşağıda bazı en iyi seçeneklerin karşılaştırması bulunmaktadır:

Tüm VPS karşılaştırmasını buradan bulabilirsiniz.

Sistem Gereksinimleri

Kurulumdan önce, VPS’nizin aşağıdaki gereksinimleri karşıladığından emin olun:

• En az 2GB RAM (4GB önerilir)
• 20GB SSD depolama
• Bir alan adı (isteğe bağlı, ancak önerilir)
• Docker ve Docker Compose yüklü olmalı

Adım Adım Kurulum Rehberi

Adım 1: VPS’inizi Kurun

Seçtiğiniz VPS’i sağlayın. Örneğin, Hetzner Cloud ile 4.15 EUR/ay’lık yeni bir örnek oluşturabilir veya sadece 5.99 EUR/ay karşılığında Contabo kullanabilirsiniz.

1. Sunucunuza SSH ile bağlanın:

   ssh root@your_server_ip

2. Sistem güncellemesi yapın:

   apt update && apt upgrade -y

Adım 2: Docker ve Docker Compose’u Kurun

VPS’nizde Docker ve Docker Compose’un kurulu olması gerekir. Aşağıdaki komutları kullanabilirsiniz:

1. Docker’ı yükleyin:

   apt install -y docker.io
   systemctl start docker
   systemctl enable docker

2. Docker Compose’u yükleyin:

   apt install -y docker-compose

Adım 3: Paperless-ngx’i Kurun

1. Paperless-ngx için bir dizin oluşturun:

   mkdir ~/paperless
   cd ~/paperless

2. Bir docker-compose.yml dosyası oluşturun:

   version: '3.7'
   services:
     paperless-ngx:
       image: ghcr.io/jfcherng/paperless-ngx:latest
       restart: always
       volumes:
         - ./data:/usr/src/paperless/data
       ports:
         - "8000:8000"
       environment:
         PAPERLESS_REDIS: redis://redis:6379
         PAPERLESS_DBHOST: db
         PAPERLESS_DBUSER: paperless
         PAPERLESS_DBPASS: password
     redis:
       image: redis:latest
       restart: always
     db:
       image: postgres:latest
       restart: always
       environment:
         POSTGRES_USER: paperless
         POSTGRES_PASSWORD: password
         POSTGRES_DB: paperless
       volumes:
         - ./postgres:/var/lib/postgresql/data

3. Paperless-ngx’i başlatın:

   docker-compose up -d

Adım 4: Uygulamaya Erişim

Konteynerler çalışmaya başladıktan sonra, Paperless-ngx’e web tarayıcınızda http://your_server_ip:8000 adresine giderek erişebilirsiniz. Gerçek alan adı kullanımı için Nginx veya Traefik ile ters proxy ayarlamak isteyebilirsiniz.

SSS (Sıkça Sorulan Sorular)

1. Paperless-ngx’i kendi kendinize barındırmanın faydaları nelerdir?

VPS üzerinde Paperless-ngx’i kendiniz barındırmak, gelişmiş veri kontrolü ve gizlilik sağlar, çünkü belgeleriniz üçüncü taraf hizmetler yerine sizin sunucunuzda saklanır. Bu yaklaşım, yedekleme ve güvenlik uygulamalarınız üzerinde tam kontrol sağlar. Ayrıca, hosted çözümler tarafından koyulan sınırlamalara takılmadan uygulamayı kendi ihtiyaçlarınıza göre özelleştirebilirsiniz.

2. Paperless-ngx için ne kadar depolama alanına ihtiyacım var?

Minimum önerilen depolama yaklaşık 20GB olsa da, bu tamamen yönetmeyi planladığınız belge miktarına bağlıdır. Yüksek çözünürlüklü dosyalar veya büyük sayıda belge ile ilgileniyorsanız, depolama alanınızı artırmayı düşünün. DigitalOcean veya Vultr gibi VPS sağlayıcılarının ölçeklenebilir depolama seçenekleri sunması, büyüyen dosya boyutları için akıllıca bir tercih olacaktır.

3. Aynı VPS üzerinde diğer uygulamaları çalıştırabilir miyim?

Evet, Docker kullanarak her bir hizmeti izole ederek aynı VPS üzerinde birden fazla uygulama çalıştırabilirsiniz. Her uygulama kendi konteynerinde çalışacağından, kaynak çatışmaları önlenir. Ancak, VPS’nizin bu uygulamaları eş zamanlı çalıştıracak kadar kaynak (CPU, RAM ve disk alanı) olduğundan emin olun. Sunucunuzun performansını düzenli olarak izlemek, aşırı yüklenmeyi önlemek açısından önemlidir.

Sonuç olarak, VPS üzerinde Paperless-ngx’i kendi kendinize barındırmak, belge yönetimi için ödüllendirici bir projedir ve özellikle geliştiriciler ve homelab tutkunları için çeşitli avantajlar sunar. Bu kılavuzu takip ederek, belgelerinizi güvenle organize eden bağımsız ve verimli bir sistem oluşturabilirsiniz.