From: Trenton H <holmes.trenton@gmail.com>
Date: Mon, 3 Oct 2022 16:01:07 +0000 (-0700)
Subject: Adds troubleshooting note for Kubernetes about needing to set the port again
X-Git-Tag: v1.10.0-beta.rc1~7^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F1731%2Fhead;p=thirdparty%2Fpaperless-ngx.git

Adds troubleshooting note for Kubernetes about needing to set the port again
---

diff --git a/docs/troubleshooting.rst b/docs/troubleshooting.rst
index 6d94d71009..8ab9b32240 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.