add docker images info

README.md

@@ -55,7 +55,7 @@ OGC Tiles Part 1: Core                 |  ✅ | https://docs.ogc.org/is/20-057/2
 
 Notes:
 
-We chose to avoid implementing the second part of the specification to prevent the introduction of CRS-based GeoJSON. We may review this decision in the future. 
+We chose to avoid implementing the second part of the specification to prevent the introduction of CRS-based GeoJSON. We may review this decision in the future.
 
 While we tried to follow OGC specifications to the letter, some API endpoints might have more capabilities (e.g., geometry column selection).
 
@@ -111,6 +111,37 @@ $ docker-compose up app
   <img width="700" src="https://github.com/developmentseed/tipg/assets/10407788/17494573-da43-4fd5-81f9-1cfb4e8c91f2">
 </p>
 
+
+## Docker images
+
+We are publishing two different docker images on `tag` and on every commit to `main` branch:
+
+| | Gunicorn | Uvicorn |
+|          -- |     -- |   -- |
+main commit | `ghcr.io/developmentseed/tipg:latest` | `ghcr.io/developmentseed/tipg:uvicorn-latest`
+tags | `ghcr.io/developmentseed/tipg:0.0.0` | `ghcr.io/developmentseed/tipg:uvicorn-0.0.0`
+dockerfile | [/dockerfiles/Dockerfile.gunicorn](https://github.com/developmentseed/tipg/blob/main/dockerfiles/Dockerfile.gunicorn) | [/dockerfiles/Dockerfile.uvicorn](https://github.com/developmentseed/tipg/blob/main/dockerfiles/Dockerfile.uvicorn)
+
+See all version at https://github.com/developmentseed/tipg/pkgs/container/tipg
+
+```
+# Gunicorn image
+$ docker run \
+    -p 8081:8081 \
+    -e PORT=8081 \
+    -e DATABASE_URL=postgresql://username:[email protected]:5432/postgis \
+    ghcr.io/developmentseed/tipg:latest
+
+# or Uvicorn image
+$ docker run \
+    -p 8081:8081 \
+    -e PORT=8081 \
+    -e DATABASE_URL=postgresql://username:[email protected]:5432/postgis \
+    ghcr.io/developmentseed/tipg:uvicorn-latest
+```
+
+Note: If you are planning to use the docker image in a kubernetes deployment you may want to use the `uvicorn` image (ref: https://fastapi.tiangolo.com/deployment/server-workers/).
+
 ## Contribution & Development
 
 See [CONTRIBUTING.md](https://github.com/developmentseed/tipg/blob/main/CONTRIBUTING.md)