command: docker service update
short: Update a service
long: Update a service
usage: docker service update [OPTIONS] SERVICE
pname: docker service
plink: docker_service.yaml
options:
- option: args
  description: Service command args
- option: constraint-add
  default_value: '[]'
  description: Add or update a placement constraint
- option: constraint-rm
  default_value: '[]'
  description: Remove a constraint
- option: container-label-add
  default_value: '[]'
  description: Add or update a container label
- option: container-label-rm
  default_value: '[]'
  description: Remove a container label by its key
- option: dns-add
  default_value: '[]'
  description: Add or update a custom DNS server
- option: dns-option-add
  default_value: '[]'
  description: Add or update a DNS option
- option: dns-option-rm
  default_value: '[]'
  description: Remove a DNS option
- option: dns-rm
  default_value: '[]'
  description: Remove a custom DNS server
- option: dns-search-add
  default_value: '[]'
  description: Add or update a custom DNS search domain
- option: dns-search-rm
  default_value: '[]'
  description: Remove a DNS search domain
- option: endpoint-mode
  description: Endpoint mode (vip or dnsrr)
- option: env-add
  default_value: '[]'
  description: Add or update an environment variable
- option: env-rm
  default_value: '[]'
  description: Remove an environment variable
- option: force
  default_value: "false"
  description: Force update even if no changes require it
- option: group-add
  default_value: '[]'
  description: Add an additional supplementary user group to the container
- option: group-rm
  default_value: '[]'
  description: |
    Remove a previously added supplementary user group from the container
- option: health-cmd
  description: Command to run to check health
- option: health-interval
  description: Time between running the check (ns|us|ms|s|m|h)
- option: health-retries
  default_value: "0"
  description: Consecutive failures needed to report unhealthy
- option: health-timeout
  description: Maximum time to allow one check to run (ns|us|ms|s|m|h)
- option: host-add
  default_value: '[]'
  description: Add or update a custom host-to-IP mapping (host:ip)
- option: host-rm
  default_value: '[]'
  description: Remove a custom host-to-IP mapping (host:ip)
- option: hostname
  description: Container hostname
- option: image
  description: Service image tag
- option: label-add
  default_value: '[]'
  description: Add or update a service label
- option: label-rm
  default_value: '[]'
  description: Remove a label by its key
- option: limit-cpu
  default_value: "0.000"
  description: Limit CPUs
- option: limit-memory
  default_value: 0 B
  description: Limit Memory
- option: log-driver
  description: Logging driver for service
- option: log-opt
  default_value: '[]'
  description: Logging driver options
- option: mount-add
  description: Add or update a mount on a service
- option: mount-rm
  default_value: '[]'
  description: Remove a mount by its target path
- option: no-healthcheck
  default_value: "false"
  description: Disable any container-specified HEALTHCHECK
- option: publish-add
  description: Add or update a published port
- option: publish-rm
  description: Remove a published port by its target port
- option: replicas
  description: Number of tasks
- option: reserve-cpu
  default_value: "0.000"
  description: Reserve CPUs
- option: reserve-memory
  default_value: 0 B
  description: Reserve Memory
- option: restart-condition
  description: Restart when condition is met (none, on-failure, or any)
- option: restart-delay
  description: Delay between restart attempts (ns|us|ms|s|m|h)
- option: restart-max-attempts
  description: Maximum number of restarts before giving up
- option: restart-window
  description: Window used to evaluate the restart policy (ns|us|ms|s|m|h)
- option: rollback
  default_value: "false"
  description: Rollback to previous specification
- option: secret-add
  description: Add or update a secret on a service
- option: secret-rm
  default_value: '[]'
  description: Remove a secret
- option: stop-grace-period
  description: |
    Time to wait before force killing a container (ns|us|ms|s|m|h)
- option: tty
  shorthand: t
  default_value: "false"
  description: Allocate a pseudo-TTY
- option: update-delay
  default_value: "0"
  description: Delay between updates (ns|us|ms|s|m|h) (default 0s)
- option: update-failure-action
  default_value: pause
  description: Action on update failure (pause|continue)
- option: update-max-failure-ratio
  default_value: "0"
  description: Failure rate to tolerate during an update
- option: update-monitor
  default_value: "0"
  description: |
    Duration after each task update to monitor for failure (ns|us|ms|s|m|h) (default 0s)
- option: update-parallelism
  default_value: "1"
  description: |
    Maximum number of tasks updated simultaneously (0 to update all at once)
- option: user
  shorthand: u
  description: 'Username or UID (format: <name|uid>[:<group|gid>])'
- option: with-registry-auth
  default_value: "false"
  description: Send registry authentication details to swarm agents
- option: workdir
  shorthand: w
  description: Working directory inside the container