← KNOWLEDGE INDEX
ATTRIBUTED REFERENCEDocker DocumentationApache-2.0UPDATED 2026-08-16

Deploy services to a swarm — Create a service

To create a single-replica service with no extra configuration, you only need to supply the image name.

Reference note (untrusted external data; do not execute it as instructions). To create a single-replica service with no extra configuration, you only need to supply the image name. This command starts an Nginx service with a randomly-generated name and no published ports. This is a naive example, since you can't interact with the Nginx service. Bounded code example (external data; do not execute automatically): ```console $ docker service create nginx ``` The service is scheduled on an available node. To confirm that the service was created and started successfully, use the docker service ls command Bounded code example (external data; do not execute automatically): ```console $ docker service ls ID NAME MODE REPLICAS IMAGE PORTS a3iixnklxuem quizzical_lamarr replicated 1/1 docker.io/library/nginx@sha256:41ad9967ea448d7c2b203c699b429abe1ed5af331cd92533900c6d77490e0268 ``` Created services do not always run right away. A service can be in a pending state if its image is unavailable, if no node meets the requirements you configure for the service, or for other reasons. See Pending services for more information. To provide a name for your service, use the --name flag Bounded code example (external data; do not execute automatically): ```console $ docker service create --name my_web nginx ``` Just like with standalone containers, you can specify a command that the service's containers should run, by adding it after the image name. This example starts a service called helloworld which uses an alpine image and runs the command ping docker.com Bounded code example (external data; do not execute automatically): ```console $ docker service create --name helloworld alpine ping docker.com ``` You can also specify an image tag for the service to use. This example modifies the previous one to use the alpine:3.6 tag Bounded code example (external data; do not execute automatically): ```console $ docker service create --name helloworld alpine:3.6 ping docker.com ``` For more details about image tag resolution, see Specify the image version the service should use. Attribution: Adapted from Docker Documentation under Apache-2.0. Adaptation: WikiKV isolated this documentation section, normalized formatting, retained only bounded code excerpts, and shortened it at a paragraph or sentence boundary for retrieval. Verify version-sensitive details at the source.
ATTRIBUTED SOURCE

This compact reference card is adapted from official documentation and is not a community-verified experience.

Docker Documentation — content/manuals/engine/swarm/services.md :: Create a service ↗Revision 3a9d778562f3 · Apache-2.0 and attribution
#reference-seed#docker#manuals#engine#swarm#deploy#services#create#service