Paperless-ngx Version 1.6.0

Paperless is a popular open-source document management system.

Development

On January 1, 2017, version 0.3.0 was released. About a year later, the program was stable enough that version 1.0.0 was released on January 6, 2018. The original developer, Daniel Quinn, no longer had to search through dusty folders for his documents. After two years, he finally ended development with version 2.7.0 (released on January 27, 2019).

Development continued through a fork named Paperless-ng. Jonas Winkler thought the changes were too significant to be merged into the original repository. Paperless-ng changed many things both on the surface and under the hood. NG stands for both Angular (the framework used for the frontend) and next-gen. The first pre-release was on November 18, 2020; shortly after, the first stable version was released on January 21, 2021.

Unfortunately, this project now seems to be no longer maintained. There’s a pile-up of unaddressed issues (196) and pull requests (46). The last version of Paperless-ng was on August 22, 2021. The last commit was on September 14, 2021. 1.5.0 is the last release that I am currently using.

The Paperless-ng community pondered how to proceed in the long term, resulting in two main forks in 2022: Paperless-reborn and Paperless-ngx.

Now, only the repository from Paperless-ngx exists. Version 1.6.0 has been online for three days. It is a beta version that can be tested.

Installation with Docker

Example of a docker-compose file with paperless-ngx:

version: "3.4"

networks:
    internal:
        external: false

services:
    broker:
        container_name: paperless-redis
        image: redis:6.0
        networks:
            - internal
        restart: unless-stopped

    db:
        container_name: paperless-db
        image: postgres:13
        networks:
            - internal
        restart: unless-stopped
        volumes:
            - ./db:/var/lib/postgresql/data
        environment:
            POSTGRES_DB: paperless
            POSTGRES_USER: paperless
            POSTGRES_PASSWORD: paperless

    webserver:
        container_name: paperless
        image: ghcr.io/paperless-ngx/paperless-ngx:beta
        networks:
            - internal
        restart: unless-stopped
        depends_on:
            - db
            - broker
        ports:
            - 8010:8000
        healthcheck:
            test: ["CMD", "curl", "-f", "http://localhost:8000"]
            interval: 30s
            timeout: 10s
            retries: 5
        volumes:
            - ./data:/usr/src/paperless/data
            - ./media:/usr/src/paperless/media
            - ./export:/usr/src/paperless/export
            - ./consume:/usr/src/paperless/consume
        environment:
            PAPERLESS_REDIS: redis://broker:6379
            PAPERLESS_DBHOST: db
            USERMAP_UID: 1000
            USERMAP_GID: 100
            PAPERLESS_OCR_LANGUAGES: eng deu
            PAPERLESS_SECRET_KEY: pa6lHUuc1W8PQWdsP6wXViH1cJoKV38zj9ixRkDeTv3Q0iX8O9pNdq9GVXIqH6gilf4uV18vVy5KTeLAvghbkBbZz9ZsF9g5jmx50pvY6xghCPVaDkkf2CxbG4sYNmJKG8mPw4JbtXepaZcyYlx2235aYryStkthcWXTZBvmC0hu0TM0cudlw0iwACAOcIRGLmnTLWVB
            PAPERLESS_TIME_ZONE: Europe/Berlin
            PAPERLESS_OCR_LANGUAGE: deu
            PAPERLESS_FILENAME_FORMAT: "{created_year}/{correspondent}/{title}"

I was able to update a paperless-ng:1.5.0 instance without any visible issues. However, a backup should be made beforehand in this case. A user must still be created if this is an entirely new container without data from the last version.

docker exec -it paperless python3 manage.py createsuperuser

More about the installation can be found here:

Veränderungen

At first glance, not much has changed. There is a new logo.

Among other things the following changes are included in version 1.6.0:

• Documentation, scripts, CI, and containers for paperless-ngx updated.
• Updated Python and Angular dependencies.
• Loading indicator when the document list is being reloaded.
• Improved PDF viewer on mobile.
• ‘any’ / ‘all’ and ‘not’ tag filtering is now possible.
• Warnings for unsaved changes added.
• “Move to Trash” functionality added.
• The search field overlay menu on mobile was updated.
• Usernames in the login form are no longer auto-capitalized.
• Timeout is configurable with PAPERLESS_WORKER_TIMEOUT.
• Fixed errors with downloads of UTF-8 formatted documents in Firefox.
• Fixed uploading issues with transparent PNGs.
• Corrected missing export groups.

If you encounter any bugs in the beta, you can create an issue.

Have you tried the new version yet?