diff --git a/docs/administration.rst b/docs/administration.rst index 275883a2f..42a91bcdb 100644 --- a/docs/administration.rst +++ b/docs/administration.rst @@ -8,16 +8,40 @@ Administration Making backups ############## -.. warning:: +Multiple options exist for making backups of your paperless instance, +depending on how you installed paperless. - This section is not updated to paperless-ng yet, the exporter is a valid tool - for backups though. +Before making backups, make sure that paperless is not running. -So you're bored of this whole project, or you want to make a remote backup of -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. +Options available to any installation of paperless: +* Use the :ref:`document exporter `. + The document exporter exports all your documents, thumbnails and + metadata to a specific folder. You may import your documents into a + fresh instance of paperless again or store your documents in another + DMS with this export. + +Options available to docker installations: + +* Backup the docker volumes. These usually reside within + ``/var/lib/docker/volumes`` on the host and you need to be root in order + to access them. + + Paperless uses 3 volumes: + + * ``paperless_media``: This is where your documents are stored. + * ``paperless_data``: This is where auxilliary data is stored. This + folder also contains the SQLite database, if you use it. + * ``paperless_pgdata``: Exists only if you use PostgreSQL and contains + the database. + +Options available to bare-metal and non-docker installations: + +* Backup the entire paperless folder. This ensures that if your paperless instance + crashes at some point or your disk fails, you can simply copy the folder back + into place and it works. + + When using PostgreSQL, you'll also have to backup the database. .. _migrating-restoring: @@ -25,6 +49,8 @@ Restoring ========= + + .. _administration-updating: Updating paperless diff --git a/docs/faq.rst b/docs/faq.rst index b55f5d058..3f0de32b7 100644 --- a/docs/faq.rst +++ b/docs/faq.rst @@ -35,15 +35,3 @@ in your browser and paperless has to do much less work to serve the data. that automatically, I'm all ears. For now, you have to grab the latest release archive from the project page and build the image yourself. The release comes with the front end already compiled, so you don't have to do this on the Pi. - -You may encounter some issues during the build: - -.. code:: shell-session - - W: GPG error: http://ports.ubuntu.com/ubuntu-ports focal InRelease: At least one invalid signature was encountered. - E: The repository 'http://ports.ubuntu.com/ubuntu-ports focal InRelease' is not signed. - N: Updating from such a repository can't be done securely, and is therefore disabled by default. - N: See apt-secure(8) manpage for repository creation and user configuration details. - -If this happens, look at `this thread `:_. -You will need to update docker to the latest version to fix this issue.