command: docker service rollback
short: Revert changes to a service's configuration
long: |-
  Roll back a specified service to its previous version from the swarm. This command must be run
  targeting a manager node.
usage: docker service rollback [OPTIONS] SERVICE
pname: docker service
plink: docker_service.yaml
options:
- option: detach
  shorthand: d
  value_type: bool
  default_value: "false"
  description: |
    Exit immediately instead of waiting for the service to converge
  deprecated: false
  min_api_version: "1.29"
  experimental: false
  experimentalcli: false
  kubernetes: false
  swarm: false
- option: quiet
  shorthand: q
  value_type: bool
  default_value: "false"
  description: Suppress progress output
  deprecated: false
  experimental: false
  experimentalcli: false
  kubernetes: false
  swarm: false
examples: |-
  ### Roll back to the previous version of a service

  Use the `docker service rollback` command to roll back to the previous version
  of a service. After executing this command, the service is reverted to the
  configuration that was in place before the most recent `docker service update`
  command.

  The following example creates a service with a single replica, updates the
  service to use three replicas, and then rolls back the service to the
  previous version, having one replica.

  Create a service with a single replica:

  ```bash
  $ docker service create --name my-service -p 8080:80 nginx:alpine
  ```

  Confirm that the service is running with a single replica:

  ```bash
  $ docker service ls

  ID                  NAME                MODE                REPLICAS            IMAGE               PORTS
  xbw728mf6q0d        my-service          replicated          1/1                 nginx:alpine        *:8080->80/tcp
  ```

  Update the service to use three replicas:

  ```bash
  $ docker service update --replicas=3 my-service

  $ docker service ls

  ID                  NAME                MODE                REPLICAS            IMAGE               PORTS
  xbw728mf6q0d        my-service          replicated          3/3                 nginx:alpine        *:8080->80/tcp
  ```

  Now roll back the service to its previous version, and confirm it is
  running a single replica again:

  ```bash
  $ docker service rollback my-service

  $ docker service ls

  ID                  NAME                MODE                REPLICAS            IMAGE               PORTS
  xbw728mf6q0d        my-service          replicated          1/1                 nginx:alpine        *:8080->80/tcp
  ```
deprecated: false
min_api_version: "1.31"
experimental: false
experimentalcli: false
kubernetes: false
swarm: true