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
5702	Direct-node admin HTTP (/health, /ready)	Direct admin listener when enabled outside TLS-only mode	loomcache.admin.port, YAML admin.port
5703	Direct-node admin HTTPS/TLS	Direct admin TLS listener; required with mTLS when direct admin is enabled in production	loomcache.server.health.tls.port, YAML health.tls.port
7654	Binary cluster/member TCP in samples	Docker image and Compose files	LOOMCACHE_NODE_PORT, LOOMCACHE_SERVER_PORT (Docker ENV), sample service ports
9090	Prometheus metrics HTTP (/metrics)	Direct-node metrics listener when enabled	loomcache.metrics-port, YAML health.metrics-port
8080	Spring Boot HTTP(S) / REST / Actuator	Spring Boot web server	server.port

Rules

• ClusterConfig and LoomConfig default the binary member port to 5701.
• Spring Boot embedded nodes bind with loomcache.node.port; default 5701.
• Deprecated compatibility property: loomcache.server.port. Do not use it for new deployments; set loomcache.node.port instead. loomcache.server.port is ignored by embedded-node binding and logs a warning when it differs from loomcache.node.port.
• Direct-node admin defaults (5702/5703) can collide with local member ports for second/third nodes. Disable those listeners or override their ports when running multiple direct JVM nodes on one host. Docker/Spring Boot production templates set loomcache.admin.enabled=false and use Actuator health on 8080.
• Production direct admin is allowed only as TLS-only mTLS health: health.tls.enabled=true, health.tls.plain-text-disabled=true, and a TLS config with client certificate authentication.
• Docker Compose samples use binary member container port 7654; keep seeds, container ports, service ports, and clients aligned to that value when using those samples unchanged. The checked-in Compose file assigns host ports dynamically on loopback; discover them with docker compose port <service> <port>.
• Docker Compose samples expose Spring Boot on 8080 (/actuator/prometheus); direct admin ports 5702/5703 are not published by the checked-in Compose file, and the production image disables the plain direct admin listener by default.
• 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	default 5701; choose explicit non-admin ports for collocated nodes, for example 5711, 5712	9090, 9091, 9092 if collocated	8080 only when Boot REST is enabled; override direct admin ports if they collide
Docker Compose sample	container 7654, host discovered with docker compose port <service> 7654	through Boot /actuator/prometheus on container 8080, host discovered with docker compose port <service> 8080	container 8080, host discovered with docker compose port <service> 8080
Embedded library mode	default 5701 or explicit .port(...)	none unless started	none; positive .enableRest(port) calls are rejected

For deployment templates that set these ports, see Docker & Deployment. For the underlying properties, see the Configuration Reference.