Default Ports

LoomCache has one binary member listener and optional HTTP listeners. Keep them separate: seed lists always point to the binary member port, never to metrics or REST.

Port Matrix

Port	Listener	Default owner	Configuration
5701	Binary cluster/member TCP	JVM/server config and Spring Boot node binding	port, loomcache.port, loomcache.node.port, seed addresses
7654	Binary cluster/member TCP in samples	Dockerfile and Kubernetes manifests	Docker CMD, LOOMCACHE_NODE_PORT, sample service ports
9090	Prometheus scrape port in samples	Kubernetes service to Spring Actuator, or direct metrics listener	service metrics port, loomcache.metrics-port, LOOMCACHE_METRICS_PORT
8080	Spring Boot HTTP / REST	Spring Boot web server	server.port
4317	OpenTelemetry OTLP endpoint	Tracing exporter endpoint	outbound collector target

Rules

• ClusterConfig and LoomConfig default the binary member port to 5701.
• Spring Boot embedded nodes bind with loomcache.node.port; default 5701.
• loomcache.server.port is legacy in the current Spring Boot wiring. CacheNodeConfig warns when it differs from loomcache.node.port.
• Docker and Kubernetes samples use binary member port 7654; keep seeds, container ports, service ports, and clients aligned to that value when using those samples unchanged.
• Kubernetes metrics service port 9090 targets the Spring HTTPS listener and /actuator/prometheus; direct JVM metrics use http://<node>:9090/metrics only when the standalone metrics listener is started.

Recommended Allocations

Deployment shape	Binary member port	Metrics port	REST/HTTP port
Local JVM / bare metal	5701, 5702, 5703 per node	9090, 9091, 9092 if collocated	8080 only when Boot REST is enabled
Docker Compose sample	container 7654, host 7654/7655/7656	container 9090, host 9090/9091/9092	container 8080, host 8080/8081/8082
Kubernetes sample	service/container 7654	service/container 9090	service/container 8080
Embedded library mode	default 5701 or explicit .port(...)	none unless started	.enableRest(port) only when requested

For the root repository reference, see PORTS.md.