.nh
.TH "DOCKER" "1" "Dec 2020" "Docker Community" "Docker User Manuals"

.SH NAME
.PP
docker\-service\-create \- Create a new service


.SH SYNOPSIS
.PP
\fBdocker service create [OPTIONS] IMAGE [COMMAND] [ARG...]\fP


.SH DESCRIPTION
.PP
Create a new service


.SH OPTIONS
.PP
\fB\-\-cap\-add\fP=
	Add Linux capabilities

.PP
\fB\-\-cap\-drop\fP=
	Drop Linux capabilities

.PP
\fB\-\-config\fP=
	Specify configurations to expose to the service

.PP
\fB\-\-constraint\fP=
	Placement constraints

.PP
\fB\-\-container\-label\fP=
	Container labels

.PP
\fB\-\-credential\-spec\fP=
	Credential spec for managed service account (Windows only)

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

.PP
\fB\-\-dns\fP=
	Set custom DNS servers

.PP
\fB\-\-dns\-option\fP=
	Set DNS options

.PP
\fB\-\-dns\-search\fP=
	Set custom DNS search domains

.PP
\fB\-\-endpoint\-mode\fP="vip"
	Endpoint mode (vip or dnsrr)

.PP
\fB\-\-entrypoint\fP=
	Overwrite the default ENTRYPOINT of the image

.PP
\fB\-e\fP, \fB\-\-env\fP=
	Set environment variables

.PP
\fB\-\-env\-file\fP=
	Read in a file of environment variables

.PP
\fB\-\-generic\-resource\fP=
	User defined resources

.PP
\fB\-\-group\fP=
	Set one or more supplementary user groups for the container

.PP
\fB\-\-health\-cmd\fP=""
	Command to run to check health

.PP
\fB\-\-health\-interval\fP=
	Time between running the check (ms|s|m|h)

.PP
\fB\-\-health\-retries\fP=0
	Consecutive failures needed to report unhealthy

.PP
\fB\-\-health\-start\-period\fP=
	Start period for the container to initialize before counting retries towards unstable (ms|s|m|h)

.PP
\fB\-\-health\-timeout\fP=
	Maximum time to allow one check to run (ms|s|m|h)

.PP
\fB\-h\fP, \fB\-\-help\fP[=false]
	help for create

.PP
\fB\-\-host\fP=
	Set one or more custom host\-to\-IP mappings (host:ip)

.PP
\fB\-\-hostname\fP=""
	Container hostname

.PP
\fB\-\-init\fP[=false]
	Use an init inside each service container to forward signals and reap processes

.PP
\fB\-\-isolation\fP=""
	Service container isolation mode

.PP
\fB\-l\fP, \fB\-\-label\fP=
	Service labels

.PP
\fB\-\-limit\-cpu\fP=
	Limit CPUs

.PP
\fB\-\-limit\-memory\fP=0
	Limit Memory

.PP
\fB\-\-limit\-pids\fP=0
	Limit maximum number of processes (default 0 = unlimited)

.PP
\fB\-\-log\-driver\fP=""
	Logging driver for service

.PP
\fB\-\-log\-opt\fP=
	Logging driver options

.PP
\fB\-\-max\-concurrent\fP=
	Number of job tasks to run concurrently (default equal to \-\-replicas)

.PP
\fB\-\-mode\fP="replicated"
	Service mode (replicated, global, replicated\-job, or global\-job)

.PP
\fB\-\-mount\fP=
	Attach a filesystem mount to the service

.PP
\fB\-\-name\fP=""
	Service name

.PP
\fB\-\-network\fP=
	Network attachments

.PP
\fB\-\-no\-healthcheck\fP[=false]
	Disable any container\-specified HEALTHCHECK

.PP
\fB\-\-no\-resolve\-image\fP[=false]
	Do not query the registry to resolve image digest and supported platforms

.PP
\fB\-\-placement\-pref\fP=
	Add a placement preference

.PP
\fB\-p\fP, \fB\-\-publish\fP=
	Publish a port as a node port

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

.PP
\fB\-\-read\-only\fP[=false]
	Mount the container's root filesystem as read only

.PP
\fB\-\-replicas\fP=
	Number of tasks

.PP
\fB\-\-replicas\-max\-per\-node\fP=0
	Maximum number of tasks per node (default 0 = unlimited)

.PP
\fB\-\-reserve\-cpu\fP=
	Reserve CPUs

.PP
\fB\-\-reserve\-memory\fP=0
	Reserve Memory

.PP
\fB\-\-restart\-condition\fP=""
	Restart when condition is met ("none"|"on\-failure"|"any") (default "any")

.PP
\fB\-\-restart\-delay\fP=
	Delay between restart attempts (ns|us|ms|s|m|h) (default 5s)

.PP
\fB\-\-restart\-max\-attempts\fP=
	Maximum number of restarts before giving up

.PP
\fB\-\-restart\-window\fP=
	Window used to evaluate the restart policy (ns|us|ms|s|m|h)

.PP
\fB\-\-rollback\-delay\fP=0s
	Delay between task rollbacks (ns|us|ms|s|m|h) (default 0s)

.PP
\fB\-\-rollback\-failure\-action\fP=""
	Action on rollback failure ("pause"|"continue") (default "pause")

.PP
\fB\-\-rollback\-max\-failure\-ratio\fP=0
	Failure rate to tolerate during a rollback (default 0)

.PP
\fB\-\-rollback\-monitor\fP=0s
	Duration after each task rollback to monitor for failure (ns|us|ms|s|m|h) (default 5s)

.PP
\fB\-\-rollback\-order\fP=""
	Rollback order ("start\-first"|"stop\-first") (default "stop\-first")

.PP
\fB\-\-rollback\-parallelism\fP=1
	Maximum number of tasks rolled back simultaneously (0 to roll back all at once)

.PP
\fB\-\-secret\fP=
	Specify secrets to expose to the service

.PP
\fB\-\-stop\-grace\-period\fP=
	Time to wait before force killing a container (ns|us|ms|s|m|h) (default 10s)

.PP
\fB\-\-stop\-signal\fP=""
	Signal to stop the container

.PP
\fB\-\-sysctl\fP=
	Sysctl options

.PP
\fB\-t\fP, \fB\-\-tty\fP[=false]
	Allocate a pseudo\-TTY

.PP
\fB\-\-ulimit\fP=[]
	Ulimit options

.PP
\fB\-\-update\-delay\fP=0s
	Delay between updates (ns|us|ms|s|m|h) (default 0s)

.PP
\fB\-\-update\-failure\-action\fP=""
	Action on update failure ("pause"|"continue"|"rollback") (default "pause")

.PP
\fB\-\-update\-max\-failure\-ratio\fP=0
	Failure rate to tolerate during an update (default 0)

.PP
\fB\-\-update\-monitor\fP=0s
	Duration after each task update to monitor for failure (ns|us|ms|s|m|h) (default 5s)

.PP
\fB\-\-update\-order\fP=""
	Update order ("start\-first"|"stop\-first") (default "stop\-first")

.PP
\fB\-\-update\-parallelism\fP=1
	Maximum number of tasks updated simultaneously (0 to update all at once)

.PP
\fB\-u\fP, \fB\-\-user\fP=""
	Username or UID (format: [:])

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

.PP
\fB\-w\fP, \fB\-\-workdir\fP=""
	Working directory inside the container


.SH SEE ALSO
.PP
\fBdocker\-service(1)\fP