diff --git a/docs/source/configuration/custom-traefik-ports.rst b/docs/source/configuration/custom-traefik-ports.rst
new file mode 100644
index 0000000..c1e5467
--- /dev/null
+++ b/docs/source/configuration/custom-traefik-ports.rst
@@ -0,0 +1,23 @@
+.. _custom-traefik-ports:
+
+=============================
+Change traefik defaults ports
+=============================
+
+
+In rcstack the router component by default listens on ports 443 and 80. Those could be already taken in your
+current setup. To change those ports edit the :file:`docker-compose-router.override.yaml` and edit the ports section
+In the example below, we changed port 80 to 8000 and 443 to 8443
+
+.. code-block:: yaml
+
+    services:
+
+      traefik:
+        # NOTE: the '!override' replaces the original values defined, avail on docker-compose 2.24.2+
+        # don't use it if your compose doesn't allow this syntax
+        ports: !override
+          # The HTTP port, exposed as http entrypoint
+          - "8000:80"
+          # The HTTPS port, exposed as https entrypoint
+          - "8443:443"
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 5f88308..3100931 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -53,6 +53,7 @@ handles all incoming/outgoing traffic to the stack
 - 9022 (SSH for RhodeCode traffic)
 - 3100 (Loki log aggregation)
 
+See :ref:`custom-traefik-ports` to change the defaults ports if those are already taken
 
 **Services (mandatory to run):**
 
@@ -147,9 +148,10 @@ There are two requirements for OS to be able to run whole rcstack.
     configuration/scaling-rhodecode.rst
     configuration/enable-ssl-on-traefik.rst
     configuration/ssl-certificates.rst
-    configuration/data-volumes.rst
+    configuration/custom-traefik-ports.rst
     configuration/set-license-file.rst
     configuration/set-specific-install-version.rst
+    configuration/data-volumes.rst
 
 .. toctree::
     :maxdepth: 1