DOCKER(1)

💖 DOCKER(1) 💖

okay so bestie, welcome to the Docker User Manuals page DOCKER(1) — yes, the title is the whole vibe. sit down, grab a strawberry 🍓, we're learning how to make a service and it's gonna be iconic.

---

✨ NAME ✨

docker-service-create — create a new service 💅

---

🌸 SYNOPSIS 🌸

docker service create [OPTIONS] IMAGE [COMMAND] [ARG...]

like. OPTIONS, then your IMAGE, then optionally a COMMAND and some ARG...s. that's the whole shape of it. no cap. 🫶

---

🦋 DESCRIPTION 🦋

Create a new service. that's literally it. you say the word and a service is born. main character energy fr fr. 👑

---

💅 OPTIONS 💅

okay this is the long part and I am NOT skipping a single one, so buckle up. every flag, exactly as it is:

• --cap-add= — add Linux capabilities. give the container a lil extra power 💪
• --cap-drop= — drop Linux capabilities. take that power away 🚫
• --config= — specify configurations to expose to the service
• --constraint= — placement constraints (where things are allowed to land)
• --container-label= — container labels
• --credential-spec= — credential spec for managed service account (Windows only, iykyk)
• -d, --detach[=false] — exit immediately instead of waiting for the service to converge. bye, not waiting ✌️
• --dns= — set custom DNS servers
• --dns-option= — set DNS options
• --dns-search= — set custom DNS search domains
• --endpoint-mode="vip" — endpoint mode (vip or dnsrr). default is "vip"
• --entrypoint= — overwrite the default ENTRYPOINT of the image
• -e, --env= — set environment variables
• --env-file= — read in a file of environment variables
• --generic-resource= — user defined resources
• --group= — set one or more supplementary user groups for the container
• --health-cmd="" — command to run to check health. default is ""
• --health-interval= — time between running the check (ms|s|m|h)
• --health-retries=0 — consecutive failures needed to report unhealthy. default 0
• --health-start-interval= — time between running the check during the start period (ms|s|m|h)
• --health-start-period= — start period for the container to initialize before counting retries towards unstable (ms|s|m|h)
• --health-timeout= — maximum time to allow one check to run (ms|s|m|h)
• --host= — set one or more custom host-to-IP mappings (host:ip)
• --hostname="" — container hostname. default ""
• --init[=false] — use an init inside each service container to forward signals and reap processes
• --isolation="" — service container isolation mode. default ""
• -l, --label= — service labels
• --limit-cpu= — limit CPUs
• --limit-memory=0 — limit Memory. default 0
• --limit-pids=0 — limit maximum number of processes (default 0 = unlimited)
• --log-driver="" — logging driver for service. default ""
• --log-opt= — logging driver options
• --max-concurrent= — number of job tasks to run concurrently (default equal to --replicas)
• --memory-swap=0 — swap Bytes (-1 for unlimited). default 0
• --memory-swappiness=-1 — tune memory swappiness (0-100), -1 to reset to default. default -1
• --mode="replicated" — service mode ("replicated", "global", "replicated-job", "global-job"). default "replicated"
• --mount= — attach a filesystem mount to the service
• --name="" — service name. default ""
• --network= — network attachments
• --no-healthcheck[=false] — disable any container-specified HEALTHCHECK
• --no-resolve-image[=false] — do not query the registry to resolve image digest and supported platforms
• --oom-score-adj=0 — tune host's OOM preferences (-1000 to 1000). default 0
• --placement-pref= — add a placement preference
• -p, --publish= — publish a port as a node port
• -q, --quiet[=false] — suppress progress output. shhh 🤫
• --read-only[=false] — mount the container's root filesystem as read only
• --replicas= — number of tasks
• --replicas-max-per-node=0 — maximum number of tasks per node (default 0 = unlimited)
• --reserve-cpu= — reserve CPUs
• --reserve-memory=0 — reserve Memory. default 0
• --restart-condition="" — restart when condition is met ("none", "on-failure", "any") (default "any")
• --restart-delay= — delay between restart attempts (ns|us|ms|s|m|h) (default 5s)
• --restart-max-attempts= — maximum number of restarts before giving up
• --restart-window= — window used to evaluate the restart policy (ns|us|ms|s|m|h)
• --rollback-delay=0s — delay between task rollbacks (ns|us|ms|s|m|h) (default 0s)
• --rollback-failure-action="" — action on rollback failure ("pause", "continue") (default "pause")
• --rollback-max-failure-ratio=0 — failure rate to tolerate during a rollback (default 0)
• --rollback-monitor=0s — duration after each task rollback to monitor for failure (ns|us|ms|s|m|h) (default 5s)
• --rollback-order="" — rollback order ("start-first", "stop-first") (default "stop-first")
• --rollback-parallelism=1 — maximum number of tasks rolled back simultaneously (0 to roll back all at once). default 1
• --secret= — specify secrets to expose to the service 🤫
• --stop-grace-period= — time to wait before force killing a container (ns|us|ms|s|m|h) (default 10s)
• --stop-signal="" — signal to stop the container. default ""
• --sysctl= — Sysctl options
• -t, --tty[=false] — allocate a pseudo-TTY
• --ulimit=[] — ulimit options. default []
• --update-delay=0s — delay between updates (ns|us|ms|s|m|h) (default 0s)
• --update-failure-action="" — action on update failure ("pause", "continue", "rollback") (default "pause")
• --update-max-failure-ratio=0 — failure rate to tolerate during an update (default 0)
• --update-monitor=0s — duration after each task update to monitor for failure (ns|us|ms|s|m|h) (default 5s)
• --update-order="" — update order ("start-first", "stop-first") (default "stop-first")
• --update-parallelism=1 — maximum number of tasks updated simultaneously (0 to update all at once). default 1
• -u, --user="" — username or UID (format: [:]). default ""
• --with-registry-auth[=false] — send registry authentication details to swarm agents
• -w, --workdir="" — working directory inside the container. default ""

that's the whole list. all of it. every single one. we ate and left no crumbs. 🔥

---

🎀 SEE ALSO 🎀

• docker-service(1)

---

and that's the page bestie!! go forth and create services, you've got this 💜

cute lil sign-off: this one's from the Docker Community, dated Oct 2026, and it's page DOCKER(1) of the Docker User Manuals. periodt. 💅✨