docs/_includes/cli.md

{% capture tabChar %} {% endcapture %} {% capture dockerBaseDesc %}The base command for the Docker CLI.{% endcapture %} {% if include.datafolder and include.datafile %}

Description

{% if include.datafile=="docker" %} {{ dockerBaseDesc }} {% else %} {{ site.data[include.datafolder][include.datafile].short }} {% endif %}

{% if site.data[include.datafolder][include.datafile].min_api_version %}

The client and daemon API must both be at least {{ site.data[include.datafolder][include.datafile].min_api_version }} to use this command. Use the docker version command on the client to check your client and daemon API versions.

{% endif %}

{% if site.data[include.datafolder][include.datafile].deprecated %}

This command is deprecated.

It may be removed in a future Docker version. {: .warning }

{% endif %}

{% if site.data[include.datafolder][include.datafile].experimental %}

This command is experimental.

It should not be used in production environments. {: .important }

{% endif %}

{% if site.data[include.datafolder][include.datafile].usage %}

Usage

{{ site.data[include.datafolder][include.datafile].usage | replace: tabChar,"" | strip }}{% if site.data[include.datafolder][include.datafile].cname %} COMMAND{% endif %}

{% endif %} {% if site.data[include.datafolder][include.datafile].options %}

Options

{% for option in site.data[include.datafolder][include.datafile].options %} {% endfor %}

Name, shorthand	Default	Stability	Description
`--{{ option.option }}{% if option.shorthand %} , -{{ option.shorthand }}{% endif %}`	{% if option.default_value and option.default_value != "[]" %}`{{ option.default_value }}`{% endif %}	{% if option.deprecated and option.experimental %} deprecated, experimental {% elsif option.deprecated %} deprecated {% elsif option.experimental %} experimental {% else %} stable {% endif %}	{{ option.description | replace: "|","|" | strip }}

{% endif %}

{% if site.data[include.datafolder][include.datafile].cname %}

Child commands

{% for command in site.data[include.datafolder][include.datafile].cname %} {% capture dataFileName %}{{ command | strip | replace: " ","_" }}{% endcapture %} {% endfor %}

Command	Description
[{{ command }}]({{ dataFileName | replace: "docker_","" }}/)	{{ site.data[include.datafolder][dataFileName].short }}

{% endif %}

{% unless site.data[include.datafolder][include.datafile].pname == include.datafile %}

Parent command

{% capture parentfile %}{{ site.data[include.datafolder][include.datafile].plink | replace: ".yaml", "" | replace: "docker_","" }}{% endcapture %} {% capture parentdatafile %}{{ site.data[include.datafolder][include.datafile].plink | replace: ".yaml", "" }}{% endcapture %}

{% if site.data[include.datafolder][include.datafile].pname == "docker" %} {% capture parentDesc %}{{ dockerBaseDesc }}{% endcapture %} {% else %} {% capture parentDesc %}{{ site.data[include.datafolder][parentdatafile].short }}{% endcapture %} {% endif %}

Command	Description
[{{ site.data[include.datafolder][include.datafile].pname }}]({{ parentfile }})	{{ parentDesc }}

{% endunless %}

{% unless site.data[include.datafolder][include.datafile].pname == "docker" or site.data[include.datafolder][include.datafile].pname == "dockerd" %}

Related commands

{% for command in site.data[include.datafolder][parentdatafile].cname %} {% capture dataFileName %}{{ command | strip | replace: " ","_" }}{% endcapture %} {% endfor %}

Command	Description
[{{ command }}]({{ dataFileName | replace: "docker_","" }}/)	{{ site.data[include.datafolder][dataFileName].short }}

{% endunless %}

{% unless site.data[include.datafolder][include.datafile].long == site.data[include.datafolder][include.datafile].short %}

Extended description

{{ site.data[include.datafolder][include.datafile].long }}

{% endunless %}

{% if site.data[include.datafolder][include.datafile].examples %}

Examples

{{ site.data[include.datafolder][include.datafile].examples }}

{% endif %} {% else %}

The include.datafolder or include.datafile was not set.

{% endif %}