Feb 21, 2024: Announcing Linkerd 2.15 with support for VM workloads, native sidecars, and SPIFFE! Read more »

This is not the latest version of Linkerd!
This documentation is for Linkerd 1.x, an older version with some significant differences. You may want to see the Linkerd 2.x (current) documentation instead.

Running with Docker

If you’re using Docker to run Linkerd, there is no need to pull the release binary from GitHub, as described in the previous section. Instead, Buoyant provides the following public Docker images for you:

buoyantio/linkerd:1.7.5 buoyantio/namerd:1.7.5


Both repositories have tags for all stable released versions of each image. To see a list of releases with associated changes, visit the Linkerd GitHub releases page.

In addition to the versioned tags, the “latest” tag always points to the most recent stable release. This can be useful for environments that want to pick up new code without manually bumping the dependency version, but note that the latest tag may pull an image with breaking changes from a previous version, depending on the nature of the Linkerd release.

Furthermore, the “nightly” tag is used to provide nightly builds of both Linkerd and namerd from the most recent commit on the master branch in the Linkerd GitHub repository. This image is unstable, but can be used for testing recently added features and fixes.


The default entrypoint for the Linkerd image runs the Linkerd executable, which requires that a Linkerd config file be passed to it on the command line. The easiest way to accomplish this is by mounting a config file into the container at startup.

For instance, given the following config that simply forwards http requests received on port 8080 to the Linkerd admin service running on port 9990:

  port: 9990

- protocol: http
  dtab: /svc => /$/inet/127.1/9990;
  - port: 8080

We can start the Linkerd container with:

$ docker run --name linkerd -p 9990:9990 -v `pwd`/config.yaml:/config.yaml buoyantio/linkerd:
1.7.5 /config.yaml
I 0922 02:01:12.862 THREAD1: serving http admin on /
I 0922 02:01:12.875 THREAD1: serving http on localhost/
I 0922 02:01:12.890 THREAD1: linkerd initialized.

Making sure it works

To verify that it’s working correctly, we can exec into the running container and curl Linkerd’s admin ping endpoint via the http router’s configured port:

$ docker exec linkerd curl -s 127.1:8080/admin/ping


You can also visit Linkerd’s admin UI directly in a web browser by navigating to port 9990 on your Docker host (typically localhost).

For more information about Linkerd’s admin capabilities, see the Administration page.