Skip to content

Discovery Service Configuration (discovery-service)

The discovery-service runs the Eureka registry used by the platform services for service discovery.

Runtime and Service Metadata

These settings control the Eureka server process and how it identifies itself.

Property Value / Default Env Variable Description
server.port 8761 dev SERVER_PORT Eureka server HTTP port.
server.shutdown graceful SERVER_SHUTDOWN Shutdown mode. Allowed: graceful waits for in-flight requests to finish; immediate stops without waiting.
spring.profiles.active dev SPRING_PROFILES_ACTIVE Active Spring profile. Common values: dev for local development or any custom profile with a matching application-<profile>.yml.
spring.application.name discovery-service SPRING_APPLICATION_NAME Service name used by Spring.

Actuator and Health

Actuator is Spring Boot's operational endpoint layer. It exposes health and diagnostic endpoints used by operators, load balancers, and Kubernetes probes.

Property Value / Default Env Variable Description
management.endpoints.web.exposure.include * MANAGEMENT_ENDPOINTS_WEB_EXPOSURE_INCLUDE Actuator endpoints exposed over HTTP. Allowed examples: * exposes all; health,info exposes only health and info. Restrict this in production if actuator is reachable outside the private network.
management.info.env.enabled true MANAGEMENT_INFO_ENV_ENABLED Environment-backed actuator info. Allowed: true includes configured info values; false hides environment-backed info.
management.endpoint.health.probes.enabled true MANAGEMENT_ENDPOINT_HEALTH_PROBES_ENABLED Enables Kubernetes-style health probes. Allowed: true creates liveness/readiness health groups; false exposes only standard health behavior.
management.health.livenessstate.enabled true MANAGEMENT_HEALTH_LIVENESSSTATE_ENABLED Liveness state indicator. Allowed: true exposes whether the process should be restarted; false disables this indicator.
management.health.readinessstate.enabled true MANAGEMENT_HEALTH_READINESSSTATE_ENABLED Readiness state indicator. Allowed: true exposes whether the service is ready for traffic; false disables this indicator.

Eureka Server

The Eureka server stores service registrations. Other services register here and query it to find gateway, client, router, and aggregator instances.

Property Value / Default Env Variable Description
eureka.server.enable-self-preservation false EUREKA_SERVER_ENABLE_SELF_PRESERVATION Self-preservation mode. Allowed: true protects registrations during network partitions by reducing evictions; false evicts missed-heartbeat instances aggressively, which is simpler for local/dev environments.

Eureka Instance

These settings describe how the discovery server itself appears as a Eureka instance.

Property Value / Default Env Variable Description
eureka.instance.preferIpAddress true EUREKA_INSTANCE_PREFER_IP_ADDRESS Registration address type. Allowed: true registers the instance IP address; false registers hostname.
eureka.instance.leaseRenewalIntervalInSeconds 5 EUREKA_INSTANCE_LEASE_RENEWAL_INTERVAL_IN_SECONDS Lease renewal interval.
eureka.instance.leaseExpirationDurationInSeconds 10 EUREKA_INSTANCE_LEASE_EXPIRATION_DURATION_IN_SECONDS Lease expiration duration.
eureka.instance.instance-id ${spring.application.name}:${random.value} EUREKA_INSTANCE_INSTANCE_ID Registered Eureka instance ID.
eureka.instance.hostname localhost dev EUREKA_INSTANCE_HOSTNAME Dev hostname for the Eureka server.

Eureka Client

These flags control whether the discovery server also behaves like a Eureka client. A single local registry normally leaves both disabled.

Property Value / Default Env Variable Description
eureka.client.fetch-registry false EUREKA_CLIENT_FETCH_REGISTRY Peer registry fetching. Allowed: true fetches registrations from another Eureka server; false keeps this node standalone.
eureka.client.register-with-eureka false EUREKA_CLIENT_REGISTER_WITH_EUREKA Self-registration as a client. Allowed: true registers this server with another Eureka server; false does not self-register.
eureka.client.serviceUrl.defaultZone http://localhost:8761/eureka/ dev EUREKA_CLIENT_SERVICEURL_DEFAULTZONE Dev Eureka default zone.

Logging

Property Value / Default Env Variable Description
logging.config classpath:log/logback-default.xml base, classpath:log/logback-dev.xml dev LOGGING_CONFIG Logback configuration. Dev overrides the base value.