docs/traefik

Supported tags and respective Dockerfile links

• v1.4.0-rc3, 1.4.0-rc3, v1.4, 1.4, roquefort (scratch/amd64/Dockerfile)
• v1.4.0-rc3-alpine, 1.4.0-rc3-alpine, v1.4-alpine, 1.4-alpine, roquefort-alpine (alpine/Dockerfile)
• v1.3.8, 1.3.8, v1.3, 1.3, raclette, latest (scratch/amd64/Dockerfile)
• v1.3.8-alpine, 1.3.8-alpine, v1.3-alpine, 1.3-alpine, raclette-alpine, alpine (alpine/Dockerfile)

Quick reference

• Where to get help:
  the Docker Community Forums, the Docker Community Slack, or Stack Overflow

• Where to file issues:
  https://github.com/containous/traefik-library-image/issues

• Maintained by:
  the Træfik Project

• Published image artifact details:
  repo-info repo's repos/traefik/ directory (history)
  (image metadata, transfer size, etc)

• Image updates:
  official-images PRs with label library/traefik
  official-images repo's library/traefik file (history)

• Source of this description:
  docs repo's traefik/ directory (history)

• Supported Docker versions:
  the latest release (down to 1.6 on a best-effort basis)

Træfɪk is a modern HTTP reverse proxy and load balancer made to deploy microservices with ease. It supports several backends (Docker 🐳, Swarm 🐳🐳, Mesos/Marathon, Consul, Etcd, Zookeeper, BoltDB, Rest API, file...) to manage its configuration automatically and dynamically.

Example usage

Grab a sample configuration file and rename it to traefik.toml. Enable docker provider and web UI:

################################################################
# Web configuration backend
################################################################
[web]
address = ":8080"
################################################################
# Docker configuration backend
################################################################
[docker]
domain = "docker.local"
watch = true

Start Træfɪk:

docker run -d -p 8080:8080 -p 80:80 \
-v $PWD/traefik.toml:/etc/traefik/traefik.toml \
-v /var/run/docker.sock:/var/run/docker.sock \
traefik

Start a backend server, named test:

docker run -d --name test emilevauge/whoami

And finally, you can access to your whoami server throught Træfɪk, on the domain name {containerName}.{configuredDomain}:

curl --header 'Host: test.docker.local' 'http://localhost:80/'
Hostname: 117c5530934d
IP: 127.0.0.1
IP: ::1
IP: 172.17.0.3
IP: fe80::42:acff:fe11:3
GET / HTTP/1.1
Host: 172.17.0.3:80
User-Agent: curl/7.35.0
Accept: */*
Accept-Encoding: gzip
X-Forwarded-For: 172.17.0.1
X-Forwarded-Host: 172.17.0.3:80
X-Forwarded-Proto: http
X-Forwarded-Server: f2e05c433120

The web UI http://localhost:8080 will give you an overview of the frontends/backends and also a health dashboard.

Documentation

You can find the complete documentation here.

License

View license information for the software contained in this image.