The Docker CLI
Go to file
Sebastiaan van Stijn d1617cb0c0
Deprecate special handling for quoted values for TLS flags
The `--tlscacert`, `--tlscert`, and `--tlskey` command-line flags had
non-standard behavior for handling values contained in quotes (`"` or `'`).
Normally, quotes are handled by the shell, for example, in the following
example, the shell takes care of handling quotes before passing the values
to the `docker` CLI:

    docker --some-option "some-value-in-quotes" ...

However, when passing values using an equal sign (`=`), this may not happen
and values may be handled including quotes;

    docker --some-option="some-value-in-quotes" ...

This caused issues with "Docker Machine", which used this format as part
of its `docker-machine config` output, and the CLI carried special, non-standard
handling for these flags.

Docker Machine reached EOL, and this special handling made the processing
of flag values inconsistent with other flags used, so this behavior is
deprecated. Users depending on this behavior are recommended to specify
the quoted values using a space between the flag and its value, as illustrated
above.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
(cherry picked from commit ee05a71513)
Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2025-08-18 18:18:04 +02:00
.github
cli Merge pull request #6276 from thaJeztah/28.x_backport_cli_internalize_utils 2025-08-18 11:41:10 +02:00
cli-plugins Merge pull request #6276 from thaJeztah/28.x_backport_cli_internalize_utils 2025-08-18 11:41:10 +02:00
cmd/docker Merge pull request #6276 from thaJeztah/28.x_backport_cli_internalize_utils 2025-08-18 11:41:10 +02:00
contrib
dockerfiles
docs Deprecate special handling for quoted values for TLS flags 2025-08-18 18:18:04 +02:00
e2e
experimental
internal
man
opts
pkg/kvfile
scripts
templates
vendor
.codecov.yml
.dockerignore
.gitattributes
.gitignore
.golangci.yml
.mailmap
AUTHORS
CONTRIBUTING.md
Dockerfile
LICENSE
MAINTAINERS
Makefile
NOTICE
README.md
SECURITY.md
TESTING.md
VERSION
docker-bake.hcl
docker.Makefile
vendor.mod
vendor.sum

README.md

Docker CLI

PkgGoDev Build Status Test Status Go Report Card OpenSSF Scorecard Codecov

About

This repository is the home of the Docker CLI.

Development

docker/cli is developed using Docker.

Build CLI from source:

docker buildx bake

Build binaries for all supported platforms:

docker buildx bake cross

Build for a specific platform:

docker buildx bake --set binary.platform=linux/arm64 

Build dynamic binary for glibc or musl:

USE_GLIBC=1 docker buildx bake dynbinary 

Run all linting:

docker buildx bake lint shellcheck

Run test:

docker buildx bake test

List all the available targets:

make help

In-container development environment

Start an interactive development environment:

make -f docker.Makefile shell

Brought to you courtesy of our legal counsel. For more context, see the NOTICE document in this repo.

Use and transfer of Docker may be subject to certain restrictions by the United States and other governments.

It is your responsibility to ensure that your use and/or transfer does not violate applicable laws.

For more information, see https://www.bis.doc.gov

Licensing

docker/cli is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.