compose/docs/reference/compose_push.md
Guillaume Lours 289d8a0378
Some checks failed
ci / validate (lint) (push) Has been cancelled
ci / validate (relay-lint) (push) Has been cancelled
ci / validate (relay-test) (push) Has been cancelled
ci / validate (validate-docs) (push) Has been cancelled
ci / validate (validate-go-mod) (push) Has been cancelled
ci / validate (validate-headers) (push) Has been cancelled
ci / validate (validate-mocks) (push) Has been cancelled
ci / binary (push) Has been cancelled
ci / bin-image-test (push) Has been cancelled
ci / relay-image-test (push) Has been cancelled
ci / test (push) Has been cancelled
ci / e2e (plugin, oldstable, graphdriver) (push) Has been cancelled
ci / e2e (standalone, oldstable, graphdriver) (push) Has been cancelled
ci / e2e (plugin, stable, containerd) (push) Has been cancelled
ci / e2e (plugin, stable, graphdriver) (push) Has been cancelled
ci / e2e (standalone, stable, containerd) (push) Has been cancelled
ci / e2e (standalone, stable, graphdriver) (push) Has been cancelled
docs-upstream / docs-yaml (push) Has been cancelled
merge / bin-image-prepare (push) Has been cancelled
merge / relay-image (push) Has been cancelled
merge / module-image (push) Has been cancelled
Scorecards supply-chain security / Scorecards analysis (push) Has been cancelled
zizmor / zizmor (push) Has been cancelled
ci / binary-finalize (push) Has been cancelled
ci / coverage (push) Has been cancelled
ci / ci-ok (push) Has been cancelled
ci / release (push) Has been cancelled
docs-upstream / validate (push) Has been cancelled
merge / bin-image (push) Has been cancelled
feat(push): deprecate --ignore-push-failures in favor of --ignore-missing
--ignore-push-failures swallows every push error, including
authentication and registry ones, which hides real problems when the
only expectation is that some images were never built. --ignore-missing
now covers that case on its own.

Keep the flag working but mark it deprecated: it prints a warning and
is hidden from help and docs. Make it mutually exclusive with
--ignore-missing so the two cannot be combined ambiguously.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Guillaume Lours <glours@users.noreply.github.com>
2026-10-16 18:08:20 +02:00

1.6 KiB

docker compose push

Pushes images for services to their respective registry/repository.

The following assumptions are made:

  • You are pushing an image you have built locally
  • You have access to the build key

Examples

services:
  service1:
    build: .
    image: localhost:5000/yourimage  ## goes to local registry

  service2:
    build: .
    image: your-dockerid/yourimage  ## goes to your repository on Docker Hub

Options

Name Type Default Description
--dry-run bool Execute command in dry run mode
--ignore-missing bool Skip images that are not available locally instead of failing to push them
--include-deps bool Also push images of services declared as dependencies
-q, --quiet bool Push without printing progress information

Description

Pushes images for services to their respective registry/repository.

The following assumptions are made:

  • You are pushing an image you have built locally
  • You have access to the build key

Examples

services:
  service1:
    build: .
    image: localhost:5000/yourimage  ## goes to local registry

  service2:
    build: .
    image: your-dockerid/yourimage  ## goes to your repository on Docker Hub