documentation

This commit is contained in:
jonaswinkler 2021-01-12 00:29:05 +01:00
parent 221cf12184
commit 50ba88231f
3 changed files with 10 additions and 14 deletions

View File

@ -48,9 +48,6 @@ Options available to bare-metal and non-docker installations:
Restoring Restoring
========= =========
.. _administration-updating: .. _administration-updating:
Updating Paperless Updating Paperless
@ -84,9 +81,11 @@ B. If you built the image yourself, do the following:
.. code:: shell-session .. code:: shell-session
$ git pull $ git pull
$ ./compile-frontend.sh
$ docker-compose build $ docker-compose build
$ docker-compose up $ docker-compose up
Running `docker-compose up` will also apply any new database migrations.
If you see everything working, you can start paperless-ng with "-d" to have it If you see everything working, you can start paperless-ng with "-d" to have it
run in the background. run in the background.

View File

@ -97,9 +97,10 @@ run the above mentioned components yourself.
Install Paperless from Docker Hub Install Paperless from Docker Hub
================================= =================================
1. Go to the `project page <https://github.com/jonaswinkler/paperless-ng/tree/master/docker/hub>`_ 1. Go to the `/docker/hub directory on the project page <https://github.com/jonaswinkler/paperless-ng/tree/master/docker/hub>`_
and download one of the ``docker-compose.*.yml`` files, depending on which database backend you and download one of the ``docker-compose.*.yml`` files, depending on which database backend you
want to use. Download the ``docker-compose.env`` file and the ``.env`` file as well and store them want to use. Rename this file to `docker-compose.yml`.
Download the ``docker-compose.env`` file and the ``.env`` file as well and store them
in the same directory. in the same directory.
.. hint:: .. hint::
@ -124,7 +125,6 @@ Install Paperless from Docker Hub
.. _Docker installation guide: https://docs.docker.com/engine/installation/ .. _Docker installation guide: https://docs.docker.com/engine/installation/
.. _docker-compose installation guide: https://docs.docker.com/compose/install/ .. _docker-compose installation guide: https://docs.docker.com/compose/install/
3. Modify ``docker-compose.yml`` to your preferences. You may want to change the path 3. Modify ``docker-compose.yml`` to your preferences. You may want to change the path
to the consumption directory in this file. Find the line that specifies where to the consumption directory in this file. Find the line that specifies where
to mount the consumption directory: to mount the consumption directory:
@ -201,7 +201,9 @@ Build the docker image yourself
depending on which database backend you want to use. Copy depending on which database backend you want to use. Copy
``docker-compose.env.example`` to ``docker-compose.env``. ``docker-compose.env.example`` to ``docker-compose.env``.
3. Follow steps 2 to 7 of :ref:`setup-docker_hub`. When asked to run 3. Run the `compile-frontend.sh` script. This requires `node` and `npm`.
4. Follow steps 2 to 7 of :ref:`setup-docker_hub`. When asked to run
``docker-compose up -d`` to start the containers, do ``docker-compose up -d`` to start the containers, do
.. code:: shell-session .. code:: shell-session
@ -422,12 +424,7 @@ Migration to paperless-ng is then performed in a few simple steps:
5. Adjust ``docker-compose.yml`` and ``docker-compose.env`` to your needs. 5. Adjust ``docker-compose.yml`` and ``docker-compose.env`` to your needs.
See :ref:`setup-docker_hub` for details on which edits are advised. See :ref:`setup-docker_hub` for details on which edits are advised.
6. Since ``docker-compose`` would just use the the old paperless image, we need to 6. :ref:`Update paperless. <administration-updating>`
manually build a new image:
.. code:: shell-session
$ docker-compose build
7. In order to find your existing documents with the new search feature, you need 7. In order to find your existing documents with the new search feature, you need
to invoke a one-time operation that will create the search index: to invoke a one-time operation that will create the search index:

View File

@ -118,7 +118,7 @@ to share any documents with paperless. This can be combined with any of the mobi
scanning apps out there, such as Office Lens. scanning apps out there, such as Office Lens.
Furthermore, there is the `Paperless App <https://github.com/bauerj/paperless_app>`_ as well, Furthermore, there is the `Paperless App <https://github.com/bauerj/paperless_app>`_ as well,
which no only has document upload, but also document editing and browsing. which not only has document upload, but also document browsing and download features.
.. _usage-email: .. _usage-email: