From 8e95310602f6b650c04143ea88c46211567e0266 Mon Sep 17 00:00:00 2001
From: Fabian Koller <C0nsultant@users.noreply.github.com>
Date: Thu, 14 Jan 2021 20:21:34 +0100
Subject: [PATCH 1/5] Fix ENV var name for user args in documentation
Follow-up to #214
---
docs/configuration.rst | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/docs/configuration.rst b/docs/configuration.rst
index 9d14fba71..5edc003f6 100644
--- a/docs/configuration.rst
+++ b/docs/configuration.rst
@@ -267,7 +267,7 @@ PAPERLESS_OCR_IMAGE_DPI=<num>
present in an image.
-PAPERLESS_OCR_USER_ARG=<json>
+PAPERLESS_OCR_USER_ARGS=<json>
OCRmyPDF offers many more options. Use this parameter to specify any
additional arguments you wish to pass to OCRmyPDF. Since Paperless uses
the API of OCRmyPDF, you have to specify these in a format that can be
From 19f73f5782edd8f8d98c70dd47142809e4b5861a Mon Sep 17 00:00:00 2001
From: Fabian Koller <anokfireball@posteo.de>
Date: Sat, 16 Jan 2021 10:35:07 +0100
Subject: [PATCH 2/5] Make update ansible role paths explicit
---
ansible/tasks/main.yml | 81 ++++++++++++++++++++----------------------
1 file changed, 39 insertions(+), 42 deletions(-)
diff --git a/ansible/tasks/main.yml b/ansible/tasks/main.yml
index beeee827c..fe139dcbf 100644
--- a/ansible/tasks/main.yml
+++ b/ansible/tasks/main.yml
@@ -105,46 +105,64 @@
ignore_errors: yes
register: paperlessng_current_version
+- name: register current state
+ set_fact:
+ fresh_installation: '{{ "No such file or directory" in paperlessng_current_version.stderr }}'
+ update_installation: '{{ "No such file or directory" not in paperlessng_current_version.stderr and paperlessng_current_version.stdout != paperlessng_version | string }}'
+ reconfigure_only: '{{ paperlessng_current_version.stdout == paperlessng_version | string }}'
+
- name: backup current paperless-ng installation
copy:
src: "{{ paperlessng_directory }}"
remote_src: yes
dest: "{{ paperlessng_directory }}-{{ ansible_date_time.iso8601 }}/"
- when: '"No such file or directory" not in paperlessng_current_version.stderr and paperlessng_current_version.stdout != paperlessng_version | string'
+ when: update_installation
+
+- name: remove current paperless sources
+ file:
+ path: "{{ paperlessng_directory }}/{{ item }}"
+ state: absent
+ with_items:
+ - docker
+ - docs
+ - scripts
+ - src
+ - static
+ when: update_installation
- name: create temporary directory
tempfile:
state: directory
register: tempdir
- when: '"No such file or directory" in paperlessng_current_version.stderr or paperlessng_current_version.stdout != paperlessng_version | string'
+ when: not reconfigure_only
- name: extract paperless-ng
unarchive:
src: "https://github.com/jonaswinkler/paperless-ng/releases/download/ng-{{ paperlessng_version }}/paperless-ng-{{ paperlessng_version }}.tar.xz"
remote_src: yes
dest: "{{ tempdir.path }}"
- when: '"No such file or directory" in paperlessng_current_version.stderr or paperlessng_current_version.stdout != paperlessng_version | string'
+ when: not reconfigure_only
- name: change owner and permissions of paperless-ng
command:
cmd: "{{ item }}"
warn: false
with_items:
- - "chown -R {{ paperlessng_system_user }}:{{ paperlessng_system_group }} {{ tempdir.path }}"
- - "find {{ tempdir.path }} -type d -exec chmod 0750 {} ;"
- - "find {{ tempdir.path }} -type f -exec chmod 0640 {} ;"
- when: '"No such file or directory" in paperlessng_current_version.stderr or paperlessng_current_version.stdout != paperlessng_version | string'
+ - "chown -R {{ paperlessng_system_user }}:{{ paperlessng_system_group }} {{ tempdir.path }}"
+ - "find {{ tempdir.path }} -type d -exec chmod 0750 {} ;"
+ - "find {{ tempdir.path }} -type f -exec chmod 0640 {} ;"
+ when: not reconfigure_only
- name: move paperless-ng
command:
cmd: "cp -a {{ tempdir.path }}/paperless-ng/ {{ paperlessng_directory }}"
- when: '"No such file or directory" in paperlessng_current_version.stderr or paperlessng_current_version.stdout != paperlessng_version | string'
+ when: not reconfigure_only
- name: remove temporary directory
file:
path: "{{ tempdir.path }}"
state: absent
- when: '"No such file or directory" in paperlessng_current_version.stderr or paperlessng_current_version.stdout != paperlessng_version | string'
+ when: not reconfigure_only
- name: create paperless-ng directories and set permissions
file:
@@ -281,7 +299,7 @@
dest: /etc/paperless.conf
owner: root
group: root
- mode: '0644'
+ mode: "0644"
register: configuration
- name: create paperlessng venv
@@ -299,15 +317,15 @@
requirements: "{{ paperlessng_directory }}/requirements.txt"
executable: "{{ paperlessng_virtualenv }}/bin/pip3"
extra_args: --upgrade
- when: paperlessng_current_version.stdout != paperlessng_version | string
+ when: not reconfigure_only
- name: migrate database schema
become: yes
become_user: "{{ paperlessng_system_user }}"
command: "{{ paperlessng_virtualenv }}/bin/python3 {{ paperlessng_directory }}/src/manage.py migrate"
- when: paperlessng_current_version.stdout != paperlessng_version | string
register: database_schema
changed_when: '"No migrations to apply." not in database_schema.stdout'
+ when: not reconfigure_only
- name: configure paperless superuser
become: yes
@@ -336,7 +354,7 @@
else:
User.objects.create_superuser('{{ paperlessng_superuser_name }}', '{{ paperlessng_superuser_email }}', '{{ paperlessng_superuser_password }}')
print('changed')
- command: "{{ paperlessng_virtualenv }}/bin/python3 {{ paperlessng_directory }}/src/manage.py shell -c \"{{ creation_script }}\""
+ command: '{{ paperlessng_virtualenv }}/bin/python3 {{ paperlessng_directory }}/src/manage.py shell -c "{{ creation_script }}"'
register: superuser
changed_when: superuser.stdout == 'changed'
no_log: yes
@@ -349,7 +367,7 @@
owner: "{{ paperlessng_system_user }}"
group: "{{ paperlessng_system_group }}"
mode: g-w,o-rwx
- when: venv.changed or paperlessng_current_version.stdout != paperlessng_version | string
+ when: venv.changed or not not reconfigure_only
- name: configure ghostscript for PDF
lineinfile:
@@ -372,34 +390,13 @@
]
- [
# https://www.freedesktop.org/software/systemd/man/systemd.exec.html
- {
- option: "User",
- value: "{{ paperlessng_system_user }}",
- },
- {
- option: "Group",
- value: "{{ paperlessng_system_group }}",
- },
- {
- option: "WorkingDirectory",
- value: "{{ paperlessng_directory }}/src",
- },
- {
- option: "ProtectSystem",
- value: "full",
- },
- {
- option: "NoNewPrivileges",
- value: "true",
- },
- {
- option: "PrivateUsers",
- value: "true",
- },
- {
- option: "PrivateDevices",
- value: "true",
- }
+ { option: "User", value: "{{ paperlessng_system_user }}" },
+ { option: "Group", value: "{{ paperlessng_system_group }}" },
+ { option: "WorkingDirectory", value: "{{ paperlessng_directory }}/src", },
+ { option: "ProtectSystem", value: "full" },
+ { option: "NoNewPrivileges", value: "true" },
+ { option: "PrivateUsers", value: "true" },
+ { option: "PrivateDevices", value: "true" },
]
- name: configure paperless-consumer service
From 8884a4dfdfd311c9ec44f3762b8dec9c16aa0998 Mon Sep 17 00:00:00 2001
From: Fabian Koller <anokfireball@posteo.de>
Date: Sat, 16 Jan 2021 11:52:36 +0100
Subject: [PATCH 3/5] molecule scenario to test upgrading from releases
Provide a separate scenario to install the last release, then update to
the current one.
Also includes improved deployment verification (check if uploading a
.txt through the API works).
---
.github/workflows/ansible.yml | 9 ++-
ansible/molecule/default/converge.yml | 7 ---
ansible/molecule/default/verify.yml | 14 -----
ansible/molecule/fresh/converge.yml | 7 +++
.../molecule/{default => fresh}/molecule.yml | 0
ansible/molecule/fresh/verify.yml | 60 +++++++++++++++++++
ansible/molecule/update/converge.yml | 11 ++++
ansible/molecule/update/molecule.yml | 35 +++++++++++
ansible/molecule/update/prepare.yml | 10 ++++
ansible/molecule/update/verify.yml | 60 +++++++++++++++++++
ansible/tasks/main.yml | 4 +-
11 files changed, 192 insertions(+), 25 deletions(-)
delete mode 100644 ansible/molecule/default/converge.yml
delete mode 100644 ansible/molecule/default/verify.yml
create mode 100644 ansible/molecule/fresh/converge.yml
rename ansible/molecule/{default => fresh}/molecule.yml (100%)
create mode 100644 ansible/molecule/fresh/verify.yml
create mode 100644 ansible/molecule/update/converge.yml
create mode 100644 ansible/molecule/update/molecule.yml
create mode 100644 ansible/molecule/update/prepare.yml
create mode 100644 ansible/molecule/update/verify.yml
diff --git a/.github/workflows/ansible.yml b/.github/workflows/ansible.yml
index aacc4b44e..646c7ff81 100644
--- a/.github/workflows/ansible.yml
+++ b/.github/workflows/ansible.yml
@@ -26,10 +26,15 @@ jobs:
docker --version
molecule --version
python --version
- - name: Test with molecule
+ - name: Test fresh installation with molecule
run: |
cd ansible
- molecule test
+ molecule test -s fresh
+ working-directory: "${{ github.repository }}"
+ - name: Test release update with molecule
+ run: |
+ cd ansible
+ molecule test -s update
working-directory: "${{ github.repository }}"
# # https://galaxy.ansible.com/docs/contributing/importing.html
# release:
diff --git a/ansible/molecule/default/converge.yml b/ansible/molecule/default/converge.yml
deleted file mode 100644
index 82067f417..000000000
--- a/ansible/molecule/default/converge.yml
+++ /dev/null
@@ -1,7 +0,0 @@
----
-- name: Converge
- hosts: all
- tasks:
- - name: "Include ansible"
- include_role:
- name: "ansible"
diff --git a/ansible/molecule/default/verify.yml b/ansible/molecule/default/verify.yml
deleted file mode 100644
index 4c3b86044..000000000
--- a/ansible/molecule/default/verify.yml
+++ /dev/null
@@ -1,14 +0,0 @@
----
-# This is an example playbook to execute Ansible tests.
-
-- name: Verify
- hosts: all
- gather_facts: false
- tasks:
- - name: check if webserver is up
- uri:
- url: http://localhost:8000
- status_code: [200, 302]
- return_content: yes
- register: landingpage
- failed_when: "'Sign in</button>' not in landingpage.content"
diff --git a/ansible/molecule/fresh/converge.yml b/ansible/molecule/fresh/converge.yml
new file mode 100644
index 000000000..99e25677b
--- /dev/null
+++ b/ansible/molecule/fresh/converge.yml
@@ -0,0 +1,7 @@
+---
+- name: fresh installation
+ hosts: all
+ tasks:
+ - name: install paperless-ng with default parameters
+ include_role:
+ name: ansible
diff --git a/ansible/molecule/default/molecule.yml b/ansible/molecule/fresh/molecule.yml
similarity index 100%
rename from ansible/molecule/default/molecule.yml
rename to ansible/molecule/fresh/molecule.yml
diff --git a/ansible/molecule/fresh/verify.yml b/ansible/molecule/fresh/verify.yml
new file mode 100644
index 000000000..c353783ab
--- /dev/null
+++ b/ansible/molecule/fresh/verify.yml
@@ -0,0 +1,60 @@
+---
+- name: Verify
+ hosts: all
+ gather_facts: false
+
+ vars_files:
+ - ../../defaults/main.yml
+
+ tasks:
+ - name: check if webserver is up
+ uri:
+ url: http://localhost:8000
+ status_code: [200, 302]
+ return_content: yes
+ register: landingpage
+ failed_when: "'Sign in</button>' not in landingpage.content"
+
+ - name: check if document posting works
+ uri:
+ url: http://localhost:8000/api/documents/post_document/
+ method: POST
+ body_format: form-multipart
+ body:
+ document:
+ content: FOO
+ filename: document.txt
+ mime_type: text/plain
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: post_document
+ failed_when: "'OK' not in post_document.content"
+
+ - name: verify uploaded document has been accepted
+ uri:
+ url: http://localhost:8000/api/logs/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: logs
+ failed_when: "'Consuming document.txt' not in logs.content"
+
+ # assumes txt consumption finished by now, might have to sleep a bit
+ - name: verify uploaded document has been consumed
+ uri:
+ url: http://localhost:8000/api/logs/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: logs
+ failed_when: "'document consumption finished' not in logs.content"
+
+ - name: verify uploaded document is avaiable
+ uri:
+ url: http://localhost:8000/api/documents/1/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: document
+ failed_when: "'Not found.' in document.content or 'FOO' not in document.content"
diff --git a/ansible/molecule/update/converge.yml b/ansible/molecule/update/converge.yml
new file mode 100644
index 000000000..b19a5981a
--- /dev/null
+++ b/ansible/molecule/update/converge.yml
@@ -0,0 +1,11 @@
+---
+- name: update previous release to newest release
+ hosts: all
+ tasks:
+ - name: set current version as installation target
+ set_fact:
+ paperlessng_version: 0.9.14
+
+ - name: update to newest paperless-ng release
+ include_role:
+ name: ansible
diff --git a/ansible/molecule/update/molecule.yml b/ansible/molecule/update/molecule.yml
new file mode 100644
index 000000000..27f37ba63
--- /dev/null
+++ b/ansible/molecule/update/molecule.yml
@@ -0,0 +1,35 @@
+---
+dependency:
+ name: galaxy
+driver:
+ name: docker
+platforms:
+ - name: ubuntu_focal
+ image: jrei/systemd-ubuntu:20.04
+ privileged: true
+ volumes:
+ - /sys/fs/cgroup:/sys/fs/cgroup:ro
+ tmpfs:
+ - /tmp
+ - /run
+ - /run/lock
+ override_command: False
+ # ubuntu 18.04 bionic works except that
+ # the default redis configuration expects IPv6 which is not enabled in docker by default
+ # the default Python environment is configured for ASCII instead of UTF-8
+ # ubuntu 16.04 xenial only has Python 3.5 which is EOL and breaks multiple dependencies
+ - name: debian_buster
+ image: jrei/systemd-debian:10
+ privileged: true
+ volumes:
+ - /sys/fs/cgroup:/sys/fs/cgroup:ro
+ tmpfs:
+ - /tmp
+ - /run
+ - /run/lock
+ override_command: False
+ # debian 9 stretch only has Python 3.5 which is EOL and breaks multiple dependencies
+provisioner:
+ name: ansible
+verifier:
+ name: ansible
diff --git a/ansible/molecule/update/prepare.yml b/ansible/molecule/update/prepare.yml
new file mode 100644
index 000000000..6f3734329
--- /dev/null
+++ b/ansible/molecule/update/prepare.yml
@@ -0,0 +1,10 @@
+- name: install previous release
+ hosts: all
+ tasks:
+ - name: set previous version as installation target
+ set_fact:
+ paperlessng_version: 0.9.13
+
+ - name: install previous paperless-ng release
+ include_role:
+ name: ansible
diff --git a/ansible/molecule/update/verify.yml b/ansible/molecule/update/verify.yml
new file mode 100644
index 000000000..c353783ab
--- /dev/null
+++ b/ansible/molecule/update/verify.yml
@@ -0,0 +1,60 @@
+---
+- name: Verify
+ hosts: all
+ gather_facts: false
+
+ vars_files:
+ - ../../defaults/main.yml
+
+ tasks:
+ - name: check if webserver is up
+ uri:
+ url: http://localhost:8000
+ status_code: [200, 302]
+ return_content: yes
+ register: landingpage
+ failed_when: "'Sign in</button>' not in landingpage.content"
+
+ - name: check if document posting works
+ uri:
+ url: http://localhost:8000/api/documents/post_document/
+ method: POST
+ body_format: form-multipart
+ body:
+ document:
+ content: FOO
+ filename: document.txt
+ mime_type: text/plain
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: post_document
+ failed_when: "'OK' not in post_document.content"
+
+ - name: verify uploaded document has been accepted
+ uri:
+ url: http://localhost:8000/api/logs/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: logs
+ failed_when: "'Consuming document.txt' not in logs.content"
+
+ # assumes txt consumption finished by now, might have to sleep a bit
+ - name: verify uploaded document has been consumed
+ uri:
+ url: http://localhost:8000/api/logs/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: logs
+ failed_when: "'document consumption finished' not in logs.content"
+
+ - name: verify uploaded document is avaiable
+ uri:
+ url: http://localhost:8000/api/documents/1/
+ headers:
+ Authorization: 'Basic {{ (paperlessng_superuser_name + ":" + paperlessng_superuser_password) | b64encode }}'
+ return_content: yes
+ register: document
+ failed_when: "'Not found.' in document.content or 'FOO' not in document.content"
diff --git a/ansible/tasks/main.yml b/ansible/tasks/main.yml
index fe139dcbf..a353a18ec 100644
--- a/ansible/tasks/main.yml
+++ b/ansible/tasks/main.yml
@@ -155,7 +155,7 @@
- name: move paperless-ng
command:
- cmd: "cp -a {{ tempdir.path }}/paperless-ng/ {{ paperlessng_directory }}"
+ cmd: "cp -a {{ tempdir.path }}/paperless-ng/. {{ paperlessng_directory }}"
when: not reconfigure_only
- name: remove temporary directory
@@ -367,7 +367,7 @@
owner: "{{ paperlessng_system_user }}"
group: "{{ paperlessng_system_group }}"
mode: g-w,o-rwx
- when: venv.changed or not not reconfigure_only
+ when: venv.changed or not reconfigure_only
- name: configure ghostscript for PDF
lineinfile:
From 74a1b36005e6053445d903b4f8b02a20fd993dcd Mon Sep 17 00:00:00 2001
From: Fabian Koller <anokfireball@posteo.de>
Date: Mon, 18 Jan 2021 22:48:06 +0100
Subject: [PATCH 4/5] Update administration docs with ansible update
---
docs/administration.rst | 57 +++++++++++++++++++++++++++++++++--------
1 file changed, 46 insertions(+), 11 deletions(-)
diff --git a/docs/administration.rst b/docs/administration.rst
index 32741300a..1690d49e2 100644
--- a/docs/administration.rst
+++ b/docs/administration.rst
@@ -53,6 +53,9 @@ Restoring
Updating Paperless
##################
+Docker Route
+============
+
If a new release of paperless-ng is available, upgrading depends on how you
installed paperless-ng in the first place. The releases are available at the
`release page <https://github.com/jonaswinkler/paperless-ng/releases>`_.
@@ -72,10 +75,10 @@ A. If you pull the image from the docker hub, all you need to do is:
$ docker-compose pull
$ docker-compose up
-
+
The docker-compose files refer to the ``latest`` version, which is always the latest
stable release.
-
+
B. If you built the image yourself, do the following:
.. code:: shell-session
@@ -89,13 +92,13 @@ Running `docker-compose up` will also apply any new database migrations.
If you see everything working, press CTRL+C once to gracefully stop paperless.
Then you can start paperless-ng with ``-d`` to have it run in the background.
-Updating paperless without docker
-=================================
+Bare Metal Route
+================
After grabbing the new release and unpacking the contents, do the following:
1. Update dependencies. New paperless version may require additional
- dependencies. The dependencies required are listed in the section about
+ dependencies. The dependencies required are listed in the section about
:ref:`bare metal installations <setup-bare_metal>`.
2. Update python requirements. If you use Pipenv, this is done with the following steps.
@@ -112,18 +115,50 @@ After grabbing the new release and unpacking the contents, do the following:
You can also use the included ``requirements.txt`` file instead and create the virtual
environment yourself. This file includes exactly the same dependencies.
-
+
3. Migrate the database.
.. code:: shell-session
$ cd src
$ pipenv run python3 manage.py migrate
-
+
This might not actually do anything. Not every new paperless version comes with new
database migrations.
-
-
+
+Ansible Route
+=============
+
+Most of the update process is automated when using the ansible role.
+
+1. Backup your defined role variables file outside the paperless source-tree:
+
+ .. code:: shell-session
+
+ $ cp ansible/vars.yml ~/vars.yml.old
+
+2. Pull the release tag you want to update to:
+
+ .. code:: shell-session
+
+ $ git fetch --all
+ $ git checkout ng-0.9.14
+
+3. Update the role variable definitions ``ansible/vars.yml`` (where appropriate).
+
+4. Run the ansible playbook you created created during :ref:`installation <setup-ansible>` again:
+
+ .. note::
+
+ When ansible detects that an update run is in progress, it backs up the entire ``paperlessng_directory`` to ``paperlessng_directory-TIMESTAMP``.
+ Updates can be rolled back by simply moving the timestamped folder back to the original location.
+ If the update succeeds and you want to continue using the new release, please don't forget to delete the backup folder.
+
+ .. code:: shell-session
+
+ $ ansible-playbook playbook.yml
+
+
Management utilities
####################
@@ -361,7 +396,7 @@ Documents can be stored in Paperless using GnuPG encryption.
Furthermore, the entire text content of the documents is stored plain in the
database, even if your documents are encrypted. Filenames are not encrypted as
well.
-
+
Also, the web server provides transparent access to your encrypted documents.
Consider running paperless on an encrypted filesystem instead, which will then
@@ -386,4 +421,4 @@ Basic usage to disable encryption of your document store:
decrypt_documents [--passphrase SECR3TP4SSPHRA$E]
-.. _Pipenv: https://pipenv.pypa.io/en/latest/
\ No newline at end of file
+.. _Pipenv: https://pipenv.pypa.io/en/latest/
From 02a066f8f3a0586c3ba26b11cb9c14d24af12711 Mon Sep 17 00:00:00 2001
From: Jonas Winkler <17569239+jonaswinkler@users.noreply.github.com>
Date: Tue, 19 Jan 2021 16:43:12 +0100
Subject: [PATCH 5/5] Update README.md
---
README.md | 18 +-----------------
1 file changed, 1 insertion(+), 17 deletions(-)
diff --git a/README.md b/README.md
index 12277ad65..89f55b2d9 100644
--- a/README.md
+++ b/README.md
@@ -10,8 +10,6 @@
Paperless-ng is a fork of the original project, adding a new interface and many other changes under the hood. For a detailed list of changes, have a look at the changelog in the documentation.
-This project is still in development and some things may not work as expected.
-
# How it Works
Paperless does not control your scanner, it only helps you deal with what your scanner produces.
@@ -48,7 +46,7 @@ Here's what you get:
* Paperless learns from your documents and will be able to automatically assign tags, correspondents and types to documents once you've stored a few documents in paperless.
* A task processor that processes documents in parallel and also tells you when something goes wrong. On modern multi core systems, consumption is blazing fast.
-If you want to see some screenshots of paperless-ng in action, [some are available in the documentation](https://paperless-ng.readthedocs.io/en/latest/screenshots.html).
+If you want to see some screenshots of paperless-ng in action, [some are available in the documentation](https://paperless-ng.readthedocs.io/en/latest/screenshots.html). However, some parts of the UI have changed since I took these.
For a complete list of changes from paperless, check out the [changelog](https://paperless-ng.readthedocs.io/en/latest/changelog.html)
@@ -58,20 +56,6 @@ For a complete list of changes from paperless, check out the [changelog](https:/
- Fix whatever bugs I and you find.
- Make the documentation nice.
-## Roadmap for versions beyond 1.0
-
-These are things that I want to add to paperless eventually. They are sorted by priority.
-
-- **More search.** The search backend is incredibly versatile and customizable. Searching is the most important feature of this project and thus, I want to implement things like:
- - Group and limit search results by correspondent, show “more from this” links in the results.
-- **Nested tags**. Organize tags in a hierarchical structure. This will combine the benefits of folders and tags in one coherent system.
-- **An interactive consumer** that shows its progress for documents it processes on the web page.
- - With live updates and websockets. This already works on a dev branch, but requires a lot of new dependencies, which I'm not particularly happy about.
- - Notifications when a document was added with buttons to open the new document right away.
-- **Arbitrary tag colors**. Allow the selection of any color with a color picker.
-
-Apart from that, paperless is pretty much feature complete.
-
## On the chopping block.
- **GnuPG encrypion.** [Here's a note about encryption in paperless](https://paperless-ng.readthedocs.io/en/latest/administration.html#managing-encryption). The gist of it is that I don't see which attacks this implementation protects against. It gives a false sense of security to users who don't care about how it works.