Prepare ByteGeist Toolbox v1.0.0 release

docs/DEPLOYMENT.md

@@ -0,0 +1,61 @@
+# Deployment
+
+## Local Use
+
+```bash
+npm install
+npm test
+npm run dev
+```
+
+The local development server listens on port `3001` unless `PORT` is set.
+
+## Production Update
+
+```bash
+cd /srv/bytegeist-toolbox
+git pull origin main
+docker compose down
+docker compose up -d --build
+docker compose ps
+docker compose logs --tail=100
+```
+
+## Docker Network
+
+The application joins the external Nginx Proxy Manager Docker network:
+
+```text
+nginx-proxy-manager_default
+```
+
+Nginx Proxy Manager should proxy to:
+
+```text
+http://bytegeist-toolbox:3001
+```
+
+Do not assume the Nginx Proxy Manager container name. Confirm container names with:
+
+```bash
+docker ps
+```
+
+## Internal Health Check
+
+```bash
+docker exec -it npm curl -sS http://bytegeist-toolbox:3001/health
+```
+
+The `npm` container name is environment-specific. Confirm it with:
+
+```bash
+docker ps
+```
+
+## Public Verification
+
+```bash
+curl -I https://toolbox.casko.dev
+```
+