traefik/docs/content/operations/cli.md

title	description
Traefik CLI Documentation	Learn the basics of the Traefik Proxy command line interface (CLI). Read the technical documentation.

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