traefik/docs/content/operations/cli.md
2019-09-23 14:32:04 +02:00

1.3 KiB

CLI

The Traefik Command Line {: .subtitle }

General

traefik [command] [flags] [arguments]

Use traefik [command] --help for help on any command.

Commands:

  • healthcheck Calls Traefik /ping to check the health of Traefik (the API must be enabled).
  • version Shows the current Traefik version.

Flag's usage:

# set flag_argument to flag(s)
traefik [--flag=flag_argument] [-f [flag_argument]]

# set true/false to boolean flag(s)
traefik [--flag[=true|false| ]] [-f [true|false| ]]

All flags are documented in the (static configuration) CLI reference.

!!! info "Flags are case insensitive."

healthcheck

Calls Traefik /ping to check the health of Traefik. Its exit status is 0 if Traefik is healthy and 1 otherwise.

This can be used with Docker HEALTHCHECK instruction or any other health check orchestration mechanism.

!!! info The ping endpoint must be enabled to allow the healthcheck command to call /ping.

Usage:

traefik healthcheck [command] [flags] [arguments]

Example:

$ traefik healthcheck
OK: http://:8082/ping

version

Shows the current Traefik version.

Usage:

traefik version