Halkali merkez neighborhood fatih st ozgur apt no 46 , Kucukcekmece , Istanbul , 34303 , TR
Deploy Paperless-ngx with PostgreSQL, Redis and OCR on Ubuntu, including scanner intake, email consumption, document rules, Nginx TLS, exporter backup, restore and integrity checks.
Deploy Paperless-ngx with PostgreSQL, Redis and OCR on Ubuntu, including scanner intake, email consumption, document rules, Nginx TLS, exporter backup, restore and integrity checks. Every command is presented as an operational step; replace example hostnames, passwords and secrets before execution.
Turkey (Turkish)
Germany (German)
Worldwide (English)
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.envPAPERLESS_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=dbmkdir -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 -dsudo 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:8000sudo docker compose exec -T webserver document_exporter ../export --compare-checksums --delete --no-progress-bar
find export -type f | wc -l
sha256sum export/manifest.jsonsudo 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 -dsudo docker compose exec webserver document_sanity_checker
sudo docker compose exec webserver document_index reindex --if-needed
sudo docker compose exec webserver document_create_classifiersudo 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 nginxsudo 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| Belirti / Symptom | Kök neden ve çözüm / Root cause and fix |
|---|---|
| Service or container does not start | Inspect compose configuration, dependency health, file permissions and the first fatal log line instead of repeatedly restarting. |
| Domain opens but HTTPS fails | Check A/AAAA records, ports 80/443, proxy mode, certificate challenge and conflicting reverse proxies. |
| Application cannot reach its database or queue | Use the internal service hostname, verify credentials and health checks, and keep database ports off the public interface. |
| Works initially but fails under load | Measure memory peaks, disk latency, connection pools and worker concurrency; increase capacity only after identifying the bottleneck. |
Yes after secrets are replaced, public access is restricted and a complete restore test has succeeded.
Minimums only prove the software can start. Size CPU, memory, IOPS and storage from representative workload measurements.
Yes. Use Full (strict) TLS and configure origin certificates, WebSockets and client IP forwarding where required.
Do not automatically apply major releases. Review migrations, back up data and retain the previous tested image.
Back up databases, uploaded files, persistent volumes, configuration, encryption keys and the deployed version together.
An NVMe VPS fits normal web workloads. Inference, accelerated OCR and video transcoding may require a compatible GPU.
Deploy Paperless-ngx with PostgreSQL, Redis and OCR on Ubuntu, including scanner intake, email consumption, document rules, Nginx TLS, exporter backup, restore and integrity checks.