From 001f36f69f66cd8abc24d66019431408efdc1f27 Mon Sep 17 00:00:00 2001
From: mml555 <mendel1023@gmail.com>
Date: Sat, 3 Jan 2026 22:50:22 -0500
Subject: [PATCH] `docs: add Docker section with multi-arch image`

---
 README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/README.md b/README.md
index 96b79f36..a0c54c06 100644
--- a/README.md
+++ b/README.md
@@ -202,6 +202,37 @@ If you require a .lib import library to link this to your application. You can g
 lib.exe /def:libpostal.def /out:libpostal.lib /machine:x64
 ```
 
+Docker
+------
+
+A community-maintained multi-architecture Docker image provides libpostal as an HTTP service, supporting both `linux/amd64` (Intel/AMD) and `linux/arm64` (Apple Silicon, AWS Graviton, Oracle Ampere):
+
+```bash
+# GitHub Container Registry
+docker run -d -p 4400:4400 ghcr.io/mml555/libpostal-docker:latest
+
+# Docker Hub  
+docker run -d -p 4400:4400 mml555/libpostal:latest
+```
+
+The image includes HTTP endpoints for address parsing (`/parser`) and normalization (`/expand`):
+
+```bash
+# Parse an address
+curl -X POST http://localhost:4400/parser \
+  -H "Content-Type: application/json" \
+  -d '{"text": "123 Main St, New York, NY 10001"}'
+
+# Normalize/expand an address  
+curl -X POST http://localhost:4400/expand \
+  -H "Content-Type: application/json" \
+  -d '{"text": "123 Main St"}'
+```
+
+See [mml555/libpostal-docker](https://github.com/mml555/libpostal-docker) for full documentation, Docker Compose examples, and source code.
+
+```
+
 Installation with an alternative data model
 -------------------------------------------