mid code commit

apps/PORTS.md

@@ -0,0 +1,57 @@
+# Port Assignments Reference
+
+This document lists all port assignments for Archipelago apps.
+
+## Production Ports
+
+| App | Port(s) | Protocol | Service |
+|-----|---------|----------|---------|
+| bitcoin-core | 8332, 8333 | TCP | RPC, P2P |
+| lnd | 9735, 10009, 8080 | TCP | P2P, gRPC, REST |
+| core-lightning | 9736, 9835 | TCP | P2P, gRPC |
+| btcpay-server | 80, 443 | TCP | HTTP, HTTPS |
+| nostr-rs-relay | 8081 | TCP | HTTP/WebSocket |
+| strfry | 8082 | TCP | HTTP/WebSocket |
+| did-wallet | 8083 | TCP | Web UI |
+| router | 8084, 5353, 1900 | TCP/UDP | Web UI, mDNS, SSDP |
+| web5-dwn | 3000 | TCP | HTTP API |
+| meshtastic | 4403, 1883 | TCP | HTTP API, MQTT |
+
+## Development Ports (Offset: +10000)
+
+In development mode, all ports are offset by 10000 to avoid conflicts with production services.
+
+| App | Dev Port(s) | Access URL |
+|-----|-------------|------------|
+| bitcoin-core | 18332, 18333 | http://localhost:18332 |
+| lnd | 19735, 20009, 18080 | http://localhost:18080 |
+| core-lightning | 19736, 19835 | http://localhost:19835 |
+| btcpay-server | 10080, 10443 | http://localhost:10080 |
+| nostr-rs-relay | 18081 | http://localhost:18081 |
+| strfry | 18082 | http://localhost:18082 |
+| did-wallet | 18083 | http://localhost:18083 |
+| router | 18084, 15353, 11900 | http://localhost:18084 |
+| web5-dwn | 13000 | http://localhost:13000 |
+| meshtastic | 14403, 11883 | http://localhost:14403 |
+
+## Port Conflict Resolution
+
+All apps use unique base ports to prevent conflicts. The port offset system ensures:
+- No conflicts in production (each app has unique ports)
+- No conflicts in development (offset applied automatically)
+- Easy port management via PortManager
+
+## Changing Port Offset
+
+The port offset is configurable via environment variable:
+
+```bash
+ARCHIPELAGO_PORT_OFFSET=10000
+```
+
+Or in the Archipelago config:
+
+```toml
+[dev]
+port_offset = 10000
+```