How to migrage from llinuxserver/paperless-ngx to the official container paperless-ngx/paperless-ngx

The docs clearly give a deprecation notice, but unhelpfully offer no suggestions for how to migrate safely. If someone were to even just bullet-point the steps, I’d be happy to go through them and add detail as I go which may aid others making the transition.

we have no plans to provide migration guidance to a container we don’t control.

My suggestion would be to spin up the new one in a new folder, compare the folder structure, stop new, move files accordingly, start new

edit: i stand corrected :smiley:

  redis:
    image: redis:alpine
    container_name: redis
    restart: unless-stopped
    volumes:
      - /path/to/redis/data:/data

  paperless:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    container_name: paperless
    restart: unless-stopped
    environment:
      - PAPERLESS_REDIS=redis://redis:6379
      - USERMAP_UID=${PUID}
      - USERMAP_GID=${PGID}
      - PAPERLESS_TIME_ZONE=${TZ}
      - PAPERLESS_URL=https://paperless.domain.com
    volumes:
      - /path/to/paperless/data:/usr/src/paperless/data #this would be your /config mount
      - /path/to/paperless/media:/usr/src/paperless/media
      - /path/to/paperless/export:/usr/src/paperless/export
      - /path/to/paperless/consume:/usr/src/paperless/consume
    ports:
      - 8000:8000
    depends_on:
      - redis

This will get you started. Please make sure you backup your data before you migrate.

There is a migration documentation from papeless-ngx:

https://paperless-ngx.readthedocs.io/en/latest/setup.html?highlight=backup#migrating-from-linuxserver-io-docker-image