layout	page_title	sidebar_current	description
docs	Configuration Entry Kind: Service Defaults	docs-agent-cfg_entries-service_defaults	The service-defaults config entry kind controls default global values for a service, such as its protocol.

Service Defaults

The service-defaults config entry kind controls default global values for a service, such as its protocol.

Sample Config Entries

Set the default protocol for a service to HTTP:

Kind = "service-defaults"
Name = "web"
Protocol = "http"

Kind - Must be set to service-defaults
Name (string: <required>) - Set to the name of the service being configured.
Protocol (string: "tcp") - Sets the protocol of the service. This is used by Connect proxies for things like observability features and to unlock usage of the service-splitter ^(beta) and service-router ^(beta) config entries for a service.
MeshGateway ^(beta) (MeshGatewayConfig: <optional>) - Controls the default mesh gateway configuration for this service.
- Mode (string: "") - One of none, local, or remote.

Configuration entries may be protected by ACLs.

Reading a service-defaults config entry requires service:read on itself.

Creating, updating, or deleting a service-defaults config entry requires service:write on itself.