Deploy and Host Paperless-ngx + Postgres/Redis on Railway

Self-host Paperless-ngx with Postgres, Redis, Tika, Gotenberg, generated admin credentials, and persistent document storage.

About Hosting Paperless-ngx + Postgres/Redis on Railway

• paperless: public Paperless-ngx web service
• postgres: private database for document metadata
• redis: private cache/broker service
• tika and gotenberg: private helpers for Office/email document conversion
• Persistent media/document volume
• Generated admin password, database password, and app secret

Why Deploy Paperless-ngx + Postgres/Redis on Railway

The published template deploy test created paperless, postgres, redis, gotenberg, and tika; all services reached SUCCESS; token auth returned HTTP 200; document upload returned HTTP 200; and the uploaded document remained searchable after restarting paperless.

This template favors a complete document archive path over the smallest possible service count.

Common Use Cases

• Personal document archives
• Small-team searchable document inboxes
• OCR-backed PDF and image storage
• Office document ingestion with Tika/Gotenberg
• Evaluation environments for Paperless-ngx

Dependencies for Paperless-ngx + Postgres/Redis Hosting

Paperless depends on Postgres for metadata, Redis for scheduled/background work, persistent filesystem storage for documents and media, and Tika/Gotenberg for richer document conversion.

Deployment Dependencies

• PAPERLESS_SECRET_KEY: generated Paperless secret
• PAPERLESS_ADMIN_USER: initial admin username
• PAPERLESS_ADMIN_PASSWORD: generated initial admin password
• POSTGRES_PASSWORD: generated database password
• PAPERLESS_REDIS: private Redis connection
• PORT: Railway public routing port for Paperless

After Deploy

1. Open the Paperless public URL.
2. Sign in with the generated admin credentials.
3. Upload a small test document.
4. Watch resource usage if OCR jobs become large or frequent.

Support Checklist

If a deploy fails, include all service deployment IDs, the public URL response, and log lines mentioning Postgres, Redis, document storage, Tika, or Gotenberg.