Skip to content

Registrator

Service registry bridge for Docker.

Registrator watches Docker events and keeps your service registry in sync — automatically registering containers when they start and deregistering them when they stop. No changes to your containers required: configuration is driven entirely by SERVICE_ environment variables and labels.

Supports Consul, etcd, ZooKeeper, and CoreDNS.

Multi-architecture support: linux/amd64, linux/arm64 — built with Chainguard hardened images.

Note

For linux/arm/v7, linux/arm/v6 and linux/386 support, use v8.0.1.

Warning

The SkyDNS2 backend was removed in v8.0.4 (abandoned since 2016). Use the coredns:// backend introduced in v9.0.0.

Quick start

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

See Getting Started for a full walkthrough.