From a0240cace3e3eeaeb565ab77dae08aab3e17e86f Mon Sep 17 00:00:00 2001 From: Daniel Quinn Date: Sun, 17 Jun 2018 17:08:24 +0100 Subject: [PATCH] Update docs for new encryption toggle --- docs/consumption.rst | 3 ++- docs/migrating.rst | 2 +- docs/setup.rst | 23 +++++++++++++---------- docs/utilities.rst | 4 ++-- 4 files changed, 18 insertions(+), 14 deletions(-) diff --git a/docs/consumption.rst b/docs/consumption.rst index 61517b5bf..bf62ed0a2 100644 --- a/docs/consumption.rst +++ b/docs/consumption.rst @@ -17,7 +17,8 @@ The primary method of getting documents into your database is by putting them in the consumption directory. The ``document_consumer`` script runs in an infinite loop looking for new additions to this directory and when it finds them, it goes about the process of parsing them with the OCR, indexing what it finds, and -encrypting the PDF, storing it in the media directory. +encrypting the PDF (if ``PAPERLESS_PASSPHRASE`` is set), storing it in the +media directory. Getting stuff into this directory is up to you. If you're running Paperless on your local computer, you might just want to drag and drop files there, but if diff --git a/docs/migrating.rst b/docs/migrating.rst index 4d20f4714..d97d3d4bf 100644 --- a/docs/migrating.rst +++ b/docs/migrating.rst @@ -16,7 +16,7 @@ Backing Up ---------- So you're bored of this whole project, or you want to make a remote backup of -the unencrypted files for whatever reason. This is easy to do, simply use the +your files for whatever reason. This is easy to do, simply use the :ref:`exporter ` to dump your documents and database out into an arbitrary directory. diff --git a/docs/setup.rst b/docs/setup.rst index 1467fb2c9..046589c40 100644 --- a/docs/setup.rst +++ b/docs/setup.rst @@ -63,17 +63,18 @@ Standard (Bare Metal) 1. Install the requirements as per the :ref:`requirements ` page. 2. Within the extract of master.zip go to the ``src`` directory. -3. Copy ``../paperless.conf.example`` to ``/etc/paperless.conf`` also the virtual - envrionment look there for it and open it in your favourite editor. - Because this file contains passwords it should only be readable by user root - and paperless ! Set the values for: +3. Copy ``../paperless.conf.example`` to ``/etc/paperless.conf`` and open it in + your favourite editor. Because this file contains passwords it should only + be readable by user root and paperless! Set the values for: * ``PAPERLESS_CONSUMPTION_DIR``: this is where your documents will be dumped to be consumed by Paperless. - * ``PAPERLESS_PASSPHRASE``: this is the passphrase Paperless uses to - encrypt/decrypt the original document. * ``PAPERLESS_OCR_THREADS``: this is the number of threads the OCR process will spawn to process document pages in parallel. + * ``PAPERLESS_PASSPHRASE``: this is only required if you want to use GPG to + encrypt your document files. This is the passphrase Paperless uses to + encrypt/decrypt the original documents. Don't worry about defining this + if you don't want to use encryption (the default). 4. Initialise the SQLite database with ``./manage.py migrate``. 5. Create a user for your Paperless instance with @@ -139,7 +140,8 @@ Docker Method ``PAPERLESS_PASSPHRASE`` This is the passphrase Paperless uses to encrypt/decrypt the original - document. + document. If you aren't planning on using GPG encryption, you can just + leave this undefined. ``PAPERLESS_OCR_THREADS`` This is the number of threads the OCR process will spawn to process @@ -265,10 +267,11 @@ Vagrant Method 3. Run ``vagrant ssh`` and once inside your new vagrant box, edit ``/etc/paperless.conf`` and set the values for: - * ``PAPERLESS_CONSUMPTION_DIR``: this is where your documents will be + * ``PAPERLESS_CONSUMPTION_DIR``: This is where your documents will be dumped to be consumed by Paperless. - * ``PAPERLESS_PASSPHRASE``: this is the passphrase Paperless uses to - encrypt/decrypt the original document. + * ``PAPERLESS_PASSPHRASE``: This is the passphrase Paperless uses to + encrypt/decrypt the original document. It's only required if you want + your original files to be encrypted, otherwise, just leave it unset. * ``PAPERLESS_EMAIL_SECRET``: this is the "magic word" used when consuming documents from mail or via the API. If you don't use either, leaving it blank is just fine. diff --git a/docs/utilities.rst b/docs/utilities.rst index b9ded25fc..782472c3a 100644 --- a/docs/utilities.rst +++ b/docs/utilities.rst @@ -59,8 +59,8 @@ for documents to parse and index. The process is pretty straightforward: 4. Attempt to automatically assign document attributes by doing some guesswork. Read up on the :ref:`guesswork documentation` for more information about this process. -5. Encrypt the document and store it in the ``media`` directory under - ``documents/originals``. +5. Encrypt the document (if you have a passphrase set) and store it in the + ``media`` directory under ``documents/originals``. 6. Go to #1.