diff --git a/docs/reference/commandline/manifest.md b/docs/reference/commandline/manifest.md index 682974b23734..273e5b67ded0 100644 --- a/docs/reference/commandline/manifest.md +++ b/docs/reference/commandline/manifest.md @@ -33,6 +33,13 @@ For full details on using docker manifest lists, see the registry v2 specificati The `docker manifest` command by itself performs no action. In order to operate on a manifest or manifest list, one of the subcommands must be used. +Local manifest lists (created with `docker manifest create` and removed with +`docker manifest rm`) are stored under the Docker CLI config directory +(`$DOCKER_CONFIG`, defaulting to `$HOME/.docker`). Running the CLI with `sudo` +typically switches `$HOME` to `/root`, so `sudo docker manifest rm …` looks in a +different store than a non-sudo `docker manifest create`. Prefer running without +`sudo`, or set `DOCKER_CONFIG` to the same directory for both commands. + A single manifest is information about an image, such as layers, size, and digest. The `docker manifest` command also gives you additional information, such as the OS and architecture an image was built for. diff --git a/docs/reference/commandline/manifest_rm.md b/docs/reference/commandline/manifest_rm.md index e3bd5f8c89ac..36997f67ead2 100644 --- a/docs/reference/commandline/manifest_rm.md +++ b/docs/reference/commandline/manifest_rm.md @@ -6,3 +6,5 @@ Delete one or more manifest lists from local storage + +Local lists live under `$DOCKER_CONFIG` (default `$HOME/.docker`). Using `sudo` often points at a different store — see [docker manifest](manifest.md).