diff --git a/aleph.env.tmpl b/aleph.env.tmpl
index b82cc38f29..9b9caf38cd 100644
--- a/aleph.env.tmpl
+++ b/aleph.env.tmpl
@@ -126,5 +126,9 @@ SENTRY_DSN=
 # Sentry environment description, see https://docs.sentry.io/platforms/python/configuration/environments/
 SENTRY_ENVIRONMENT=
 
-# Number of threads to use in servicelayer workers, 0 = disabled.
-WORKER_THREADS=0
+# Number of threads to use in servicelayer workers.
+# Set this to 0 to disable threads and use one worker per process.
+# Non-zero values use as many threads as specified.
+# If unset workers will use as many threads as there are logical CPUs installed.
+# See https://docs.aleph.occrp.org/developers/installation/#scaling-workers
+# WORKER_THREADS=