Consul

HashiCorp Consul is the primary supported backend.

URI schemes

Scheme	Description
consul://host:port	Standard HTTP connection
consul-tls://host:port	TLS connection
consul-unix:///path/to/socket	Unix socket

Example

docker run -d \
  --name=registrator \
  --net=host \
  --volume=/var/run/docker.sock:/tmp/docker.sock \
  fayrus/registrator:latest \
    consul://localhost:8500

Tag override

By default, registrator overwrites all tags on re-registration. If you use external agents (e.g. Consul itself or other tools) to manage tags, set SERVICE_ENABLE_TAG_OVERRIDE=true on the container to prevent registrator from overwriting them.

docker run -d \
  -e SERVICE_NAME=myapp \
  -e SERVICE_ENABLE_TAG_OVERRIDE=true \
  myapp:latest