From ac3b2f3dce2dff00ce1eaf374ef7bd720c30cf64 Mon Sep 17 00:00:00 2001
From: zstadler <zeev.stadler@gmail.com>
Date: Mon, 5 Dec 2022 07:02:05 +0200
Subject: [PATCH] usage.rst: Add "Docker and `--port`" section (#651)

---
 docs/usage.rst | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/usage.rst b/docs/usage.rst
index 127af2d..c81a110 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -36,3 +36,9 @@ It is possible to reload the configuration file without restarting the whole pro
 
 - The `docker kill -s HUP tileserver-gl` command can be used when running the tileserver-gl docker container.
 - The `docker-compose kill -s HUP tileserver-gl-service-name` can be used when tileserver-gl is run as a docker-compose service.
+
+Docker and `--port`
+======
+
+When running tileserver-gl in a Docker container, using the `--port` option would make the container incorrectly seem unhealthy.
+Instead, it is advised to use Docker's port mapping and map the default port 8080 to the desired external port.