$ mkdir -p /data/paperless/{data,media,export,consume,db} mkdir -p /data/paperless/{data,media,export,consume,db} mkdir -p /data/paperless/{data,media,export,consume,db} nano -weight: 500;">docker-compose.yml nano -weight: 500;">docker-compose.yml nano -weight: 500;">docker-compose.yml version: "3.8" services: broker: image: redis:7 container_name: paperless-redis -weight: 500;">restart: unless-stopped command: redis-server --save "" --appendonly no db: image: postgres:15 container_name: paperless-db -weight: 500;">restart: unless-stopped environment: POSTGRES_DB: paperless POSTGRES_USER: paperless POSTGRES_PASSWORD: paperless_password_change_me volumes: - /data/paperless/db:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U paperless"] interval: 10s timeout: 5s retries: 5 webserver: image: ghcr.io/paperless-ngx/paperless-ngx:latest container_name: paperless -weight: 500;">restart: unless-stopped depends_on: db: condition: service_healthy broker: condition: service_started ports: - "8000:8000" environment: PAPERLESS_REDIS: redis://broker:6379 PAPERLESS_DBHOST: db PAPERLESS_DBNAME: paperless PAPERLESS_DBUSER: paperless PAPERLESS_DBPASS: paperless_password_change_me # Uncomment if using a domain: # PAPERLESS_URL: https://paperless.yourdomain.com # PAPERLESS_CSRF_TRUSTED_ORIGINS: https://paperless.yourdomain.com PAPERLESS_SECRET_KEY: "change_me_to_something_long_and_random" USERMAP_UID: 1000 USERMAP_GID: 1000 PAPERLESS_OCR_LANGUAGE: eng PAPERLESS_TIME_ZONE: Europe/London PAPERLESS_OCR_LANGUAGES: eng PAPERLESS_CONSUMER_POLLING: 60 PAPERLESS_FILENAME_FORMAT: "{created_year}/{correspondent}/{title}" volumes: - /data/paperless/data:/usr/src/paperless/data - /data/paperless/media:/usr/src/paperless/media - /data/paperless/export:/usr/src/paperless/export - /data/paperless/consume:/usr/src/paperless/consume version: "3.8" services: broker: image: redis:7 container_name: paperless-redis -weight: 500;">restart: unless-stopped command: redis-server --save "" --appendonly no db: image: postgres:15 container_name: paperless-db -weight: 500;">restart: unless-stopped environment: POSTGRES_DB: paperless POSTGRES_USER: paperless POSTGRES_PASSWORD: paperless_password_change_me volumes: - /data/paperless/db:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U paperless"] interval: 10s timeout: 5s retries: 5 webserver: image: ghcr.io/paperless-ngx/paperless-ngx:latest container_name: paperless -weight: 500;">restart: unless-stopped depends_on: db: condition: service_healthy broker: condition: service_started ports: - "8000:8000" environment: PAPERLESS_REDIS: redis://broker:6379 PAPERLESS_DBHOST: db PAPERLESS_DBNAME: paperless PAPERLESS_DBUSER: paperless PAPERLESS_DBPASS: paperless_password_change_me # Uncomment if using a domain: # PAPERLESS_URL: https://paperless.yourdomain.com # PAPERLESS_CSRF_TRUSTED_ORIGINS: https://paperless.yourdomain.com PAPERLESS_SECRET_KEY: "change_me_to_something_long_and_random" USERMAP_UID: 1000 USERMAP_GID: 1000 PAPERLESS_OCR_LANGUAGE: eng PAPERLESS_TIME_ZONE: Europe/London PAPERLESS_OCR_LANGUAGES: eng PAPERLESS_CONSUMER_POLLING: 60 PAPERLESS_FILENAME_FORMAT: "{created_year}/{correspondent}/{title}" volumes: - /data/paperless/data:/usr/src/paperless/data - /data/paperless/media:/usr/src/paperless/media - /data/paperless/export:/usr/src/paperless/export - /data/paperless/consume:/usr/src/paperless/consume version: "3.8" services: broker: image: redis:7 container_name: paperless-redis -weight: 500;">restart: unless-stopped command: redis-server --save "" --appendonly no db: image: postgres:15 container_name: paperless-db -weight: 500;">restart: unless-stopped environment: POSTGRES_DB: paperless POSTGRES_USER: paperless POSTGRES_PASSWORD: paperless_password_change_me volumes: - /data/paperless/db:/var/lib/postgresql/data healthcheck: test: ["CMD-SHELL", "pg_isready -U paperless"] interval: 10s timeout: 5s retries: 5 webserver: image: ghcr.io/paperless-ngx/paperless-ngx:latest container_name: paperless -weight: 500;">restart: unless-stopped depends_on: db: condition: service_healthy broker: condition: service_started ports: - "8000:8000" environment: PAPERLESS_REDIS: redis://broker:6379 PAPERLESS_DBHOST: db PAPERLESS_DBNAME: paperless PAPERLESS_DBUSER: paperless PAPERLESS_DBPASS: paperless_password_change_me # Uncomment if using a domain: # PAPERLESS_URL: https://paperless.yourdomain.com # PAPERLESS_CSRF_TRUSTED_ORIGINS: https://paperless.yourdomain.com PAPERLESS_SECRET_KEY: "change_me_to_something_long_and_random" USERMAP_UID: 1000 USERMAP_GID: 1000 PAPERLESS_OCR_LANGUAGE: eng PAPERLESS_TIME_ZONE: Europe/London PAPERLESS_OCR_LANGUAGES: eng PAPERLESS_CONSUMER_POLLING: 60 PAPERLESS_FILENAME_FORMAT: "{created_year}/{correspondent}/{title}" volumes: - /data/paperless/data:/usr/src/paperless/data - /data/paperless/media:/usr/src/paperless/media - /data/paperless/export:/usr/src/paperless/export - /data/paperless/consume:/usr/src/paperless/consume -weight: 500;">docker compose up -d -weight: 500;">docker compose up -d -weight: 500;">docker compose up -d http://YOUR_SERVER_IP:8000 http://YOUR_SERVER_IP:8000 http://YOUR_SERVER_IP:8000 -weight: 500;">docker exec -it paperless python3 manage.py createsuperuser -weight: 500;">docker exec -it paperless python3 manage.py createsuperuser -weight: 500;">docker exec -it paperless python3 manage.py createsuperuser cp *.pdf /data/paperless/consume/ cp *.pdf /data/paperless/consume/ cp *.pdf /data/paperless/consume/ PAPERLESS_URL: https://your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com PAPERLESS_URL: https://your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com PAPERLESS_URL: https://your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com,https://www.your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com,https://www.your-domain.com PAPERLESS_CSRF_TRUSTED_ORIGINS: https://your-domain.com,https://www.your-domain.com rsync -av /data/paperless /backup/ rsync -av /data/paperless /backup/ rsync -av /data/paperless /backup/ - Ubuntu server (20.04 or newer) - Docker installed - Docker Compose installed - Terminal access (SSH) - data – metadata - media – the actual document files - export – exported documents - consume – incoming folder for automatic import - db – database files - Email (optional) - Drag & Drop in the browser - The Upload button in the UI - Automatic import via the consume folder: - Do NOT add a trailing slash / at the end of the URL - If you use www, add both versions: - Make sure you created a superuser (Step 4) - Try clearing your browser cache/cookies - Verify that all containers are running: -weight: 500;">docker compose ps - Check language settings in your environment variables - This is normal during the initial indexing phase - OCR is CPU-intensive — be patient on lower-end hardware - Use strong, unique passwords - Set up regular backups: - Use the /consume folder to automate document ingestion - Organize documents with tags and correspondents from the -weight: 500;">start - Set up automated backups from day one - Use a domain with HTTPS if accessible over the internet - Restrict access if the instance is publicly reachable