---
name: "docker-stack-deploy"
section: "1"
platform: "linux"
package: "docker"
version: "1:29.9.2-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/docker-stack-deploy"
---

# docker-stack-deploy(1)

Deploy a new stack or update an existing stack

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

Deploy a new stack or update an existing stack

## 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

**[docker-stack(1)](/docker-stack/1.md)**