Public | Automated Build

Last pushed: 3 months ago
Short Description
Service registry bridge for Docker forked from gliderlabs/registrator.
Full Description


Service registry bridge for Docker forked from gliderlabs/registrator.

Registrator automatically registers and deregisters services for any Docker
container by inspecting containers as they come online. Registrator
supports pluggable service registries, which currently includes
Consul, etcd and
SkyDNS 2.

Full documentation available at

Getting Registrator

Get the latest release, master, or any version of Registrator via Docker Hub:

$ docker pull olafnorge/golang-registrator:latest

Latest tag always points to the latest release. There is also a :master tag
and version tags to pin to specific releases.

Using Registrator

The quickest way to see Registrator in action is our
tutorial. Otherwise, jump to the Run
in the User
Guide. Typically, running Registrator looks like this:

$ docker run -d \
    --cap-drop=all \
    --name=registrator \
    --read-only \
    --security-opt=no-new-privileges \
    --user="registrator:$(getent group docker | awk -F':' '{print $3}')" \
    --volume=/etc/localtime:/etc/localtime:ro \
    --volume=/etc/timezone:/etc/timezone:ro \
    --volume=/var/run/docker.sock:/tmp/docker.sock \
    olafnorge/golang-registrator:latest \

CLI Options

Usage of /bin/registrator:
  /bin/registrator [options] <registry URI>

  -cleanup=false: Remove dangling services
  -deregister="always": Deregister exited services "always" or "on-success"
  -internal=false: Use internal ports instead of published ones
  -ip="": IP for ports mapped to the host
  -resync=0: Frequency with which services are resynchronized
  -retry-attempts=0: Max retry attempts to establish a connection with the backend. Use -1 for infinite retries
  -retry-interval=2000: Interval (in millisecond) between retry-attempts.
  -tags="": Append tags for all registered services
  -ttl=0: TTL for services (default is no expiry)
  -ttl-refresh=0: Frequency with which service TTLs are refreshed


Pull requests are welcome! We recommend getting feedback before starting by
opening a GitHub issue.


Docker Pull Command
Source Repository