From 5fd394726ee1718d762c71efb4203f0e66c1df54 Mon Sep 17 00:00:00 2001 From: Trenton H Date: Mon, 3 Oct 2022 09:01:07 -0700 Subject: [PATCH] Adds troubleshooting note for Kubernetes about needing to set the port again --- docs/troubleshooting.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst index 6d94d7100..8ab9b3224 100644 --- a/docs/troubleshooting.rst +++ b/docs/troubleshooting.rst @@ -317,3 +317,12 @@ Uploading or consuming multiple files at once results in many workers attempting Consider changing to the PostgreSQL database if you will be processing many documents at once often. Otherwise, try tweaking the ``PAPERLESS_DB_TIMEOUT`` setting to allow more time for the database to unlock. This may have minor performance implications. + + +gunicorn fails to start with "is not a valid port number" +######################################################### + +You are likely running using Kubernetes, which automatically creates an environment variable named `${serviceName}_PORT`. +This is the same environment variable which is used by Paperless to optionally change the port gunicorn listens on. + +To fix this, set `PAPERLESS_PORT` again to your desired port, or the default of 8000.