diff --git a/docs/PORTS.md b/docs/PORTS.md
new file mode 100644
index 00000000..14cf69d8
--- /dev/null
+++ b/docs/PORTS.md
@@ -0,0 +1,30 @@
+Ports et usages (mise à jour: 2025-09-24)
+
+Contexte: déploiement sur dev4 avec Nginx en frontal, lecoffre-front en Docker.
+
+- 80 (TCP) — Nginx HTTP (host)
+- 443 (TCP) — Nginx HTTPS (host)
+
+- 3004 (TCP) — docker-proxy → lecoffre-front:8080 (port public du front via Docker)
+  - Interne conteneur: 8080 (Next.js `next start`)
+
+- 3005 (TCP) — docker-proxy → Grafana:3000
+- 3006 (TCP) — docker-proxy → status-api:3006
+- 3100 (TCP) — docker-proxy → Loki:3100
+- 8000 (TCP) — docker-proxy → blindbit-oracle:8000
+- 8081 (TCP) — docker-proxy → sdk_storage:8080
+- 3001 (TCP) — docker-proxy → sdk_signer:9090 (peut être stoppé sur cette machine si non requis)
+
+Ports désactivés/libérés
+
+- 3000 (TCP) — vhost local Nginx `local.4nkweb.com-3000` désactivé
+- 7777/7778 (TCP) — anciens processus Node arrêtés
+- 8080 (TCP host) — ancien Node local arrêté (ne pas confondre avec 8080 interne du conteneur front)
+
+Notes
+
+- Canonical front sous sous-chemin: `/lecoffre/`
+- Next.js: `basePath: '/lecoffre'`, `assetPrefix: '/lecoffre'`, `trailingSlash: true`
+- Nginx: rediriger `/lecoffre` → `/lecoffre/`, et proxy sur `^~ /lecoffre/` vers `http://localhost:3004`
+
+