DOCKER(1) Docker User Manuals DOCKER(1)

# [NAME](#NAME)

docker-stack-deploy - Deploy a new stack or update an existing stack

# [SYNOPSIS](#SYNOPSIS)

**docker stack deploy \[OPTIONS] STACK**

# [DESCRIPTION](#DESCRIPTION)

Deploy a new stack or update an existing stack

# [OPTIONS](#OPTIONS)

**-c**, **--compose-file**=\[] Path to a Compose file, or "-" to read from stdin

**-d**, **--detach**\[=true] Exit immediately instead of waiting for the stack services to converge

**--prune**\[=false] Prune services that are no longer referenced

**-q**, **--quiet**\[=false] Suppress progress output

**--resolve-image**="always" Query the registry to resolve image digest and supported platforms ("always", "changed", "never")

**--with-registry-auth**\[=false] Send registry authentication details to Swarm agents

# [SEE ALSO](#SEE_ALSO)

[**docker-stack(1)**](/man/enterprise-packages/docker-cli-fips/docker-stack.1)

Oct 2026 Docker Community

---

Document: docker-stack-deploy(1) from docker-cli-fips 29.9.2-r2 (Chainguard OS)
Source: https://github.com/docker/cli