.nh
.TH "DOCKER" "1" "Feb 2026" "Docker Community" "Docker User Manuals"

.SH NAME
docker-stack-deploy - Deploy a new stack or update an existing stack


.SH SYNOPSIS
\fBdocker stack deploy [OPTIONS] STACK\fP


.SH DESCRIPTION
Deploy a new stack or update an existing stack


.SH OPTIONS
\fB-c\fP, \fB--compose-file\fP=[]
	Path to a Compose file, or "-" to read from stdin

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

.PP
\fB--prune\fP[=false]
	Prune services that are no longer referenced

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	Suppress progress output

.PP
\fB--resolve-image\fP="always"
	Query the registry to resolve image digest and supported platforms ("always", "changed", "never")

.PP
\fB--with-registry-auth\fP[=false]
	Send registry authentication details to Swarm agents


.SH SEE ALSO
\fBdocker-stack(1)\fP