Skip to content
LoomCache

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

Section titled “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

Section titled “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.
Section titled “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.

LoomCache is an independent open-source project. It is not affiliated with, endorsed by, or sponsored by Hazelcast, Inc. or by any other company whose products are named in this documentation. “Hazelcast” is a trademark of Hazelcast, Inc.; references to it are nominative and describe only migration and comparison. All other product and company names are trademarks of their respective owners and are used for identification purposes only.