From 1f2079f65a755d3492d558ae98807282faf7783e Mon Sep 17 00:00:00 2001 From: Erik Arvstedt Date: Fri, 23 Mar 2018 10:59:52 +0100 Subject: [PATCH] Use --noreload for permanent server start commands Without it, the server is highly resource-intensive even when running idle --- docker-compose.yml.example | 2 +- docs/setup.rst | 2 +- docs/utilities.rst | 7 +++++-- scripts/paperless-webserver.service | 2 +- 4 files changed, 8 insertions(+), 5 deletions(-) diff --git a/docker-compose.yml.example b/docker-compose.yml.example index 73cf24c96..557d46bf0 100644 --- a/docker-compose.yml.example +++ b/docker-compose.yml.example @@ -24,7 +24,7 @@ services: # value with nothing. environment: - PAPERLESS_OCR_LANGUAGES= - command: ["runserver", "--insecure", "0.0.0.0:8000"] + command: ["runserver", "--insecure", "--noreload", "0.0.0.0:8000"] consumer: build: ./ diff --git a/docs/setup.rst b/docs/setup.rst index ef6c33468..1467fb2c9 100644 --- a/docs/setup.rst +++ b/docs/setup.rst @@ -352,7 +352,7 @@ after restarting your system: respawn limit 10 5 script - exec /srv/paperless/src/manage.py runserver 0.0.0.0:80 + exec /srv/paperless/src/manage.py runserver --noreload 0.0.0.0:80 end script Note that you'll need to replace ``/srv/paperless/src/manage.py`` with the diff --git a/docs/utilities.rst b/docs/utilities.rst index ca5af6a3f..25dbd9e49 100644 --- a/docs/utilities.rst +++ b/docs/utilities.rst @@ -33,8 +33,11 @@ The webserver is started via the ``manage.py`` script: By default, the server runs on localhost, port 8000, but you can change this with a few arguments, run ``manage.py --help`` for more information. -Note that this command runs continuously, so exiting it will mean your webserver -disappears. If you want to run this full-time (which is kind of the point) +Add the option ``--noreload`` to reduce resource usage. Otherwise, the server +continuously polls all source files for changes to auto-reload them. + +Note that when exiting this command your webserver will disappear. +If you want to run this full-time (which is kind of the point) you'll need to have it start in the background -- something you'll need to figure out for your own system. To get you started though, there are Systemd service files in the ``scripts`` directory. diff --git a/scripts/paperless-webserver.service b/scripts/paperless-webserver.service index 9d20f5a1c..b4eb53dd0 100644 --- a/scripts/paperless-webserver.service +++ b/scripts/paperless-webserver.service @@ -4,7 +4,7 @@ Description=Paperless webserver [Service] User=paperless Group=paperless -ExecStart=/home/paperless/project/virtualenv/bin/python /home/paperless/project/src/manage.py runserver 0.0.0.0:8000 +ExecStart=/home/paperless/project/virtualenv/bin/python /home/paperless/project/src/manage.py runserver --noreload 0.0.0.0:8000 [Install] WantedBy=multi-user.target