archy/apps/PORTS.md

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:

ARCHIPELAGO_PORT_OFFSET=10000

Or in the Archipelago config:

[dev]
port_offset = 10000