DOCKER(1)

πŸ‘‘ DOCKER(1) β€” the Docker User Manuals era ✨

okay bestie, welcome to the Docker User Manuals, section 1, and we are about to talk about the most glow-up-coded command in the whole swarm situation. buckle up πŸŽ€


🌸 NAME 🌸

docker-swarm-update β€” Update the swarm

yes that's it. that's the whole name. update the swarm. short, sweet, iconic, main character energy πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

docker swarm update [OPTIONS]

that's the vibe. command, then options. no cap. ✨


πŸ’– DESCRIPTION πŸ’–

Update the swarm.

like... that's literally the whole thing the manpage says and honestly? it ate. you run it, you tweak your swarm's settings, the swarm updates. obsessed. no extra lore, no plot twist, just a manager being a manager. 🫢

heads up bestie: you're changing swarm-wide config here, so this is a manager node kind of activity. don't go wild on a worker and then act surprised πŸ™ˆ

✨ OPTIONS ✨

every single flag, no skips, no shortcuts, we are thorough in this group chat πŸ’œ

  • --autolock[=false] β€” flip the manager autolocking setting on or off. values are true|false. it defaults to false, so if you want the lock, you gotta say the lock πŸ”’
  • --cert-expiry=2160h0m0s β€” how long node certificates stay valid for. the unit can be ns|us|ms|s|m|h. default is 2160h0m0s, which is a very long time, and honestly same, we love longevity 🌈
  • --dispatcher-heartbeat=5s β€” the dispatcher heartbeat period, aka how often the swarm's dispatcher checks in. unit is ns|us|ms|s|m|h. default 5s. it's giving consistent communication, it's giving healthy relationship πŸ’“
  • --external-ca= β€” specifications of one or more certificate signing endpoints. it's empty by default (no external CA), so if you're bringing your own CA, this is your moment πŸ‘‘
  • --max-snapshots=0 β€” number of additional Raft snapshots to retain. default 0, meaning zero extra snapshots hanging around. minimalism queen 🧚
  • --snapshot-interval=10000 β€” number of log entries between Raft snapshots. default 10000. so every ten thousand entries, we snapshot. periodt. πŸ“Έ
  • --task-history-limit=5 β€” task history retention limit. default 5. keep the receipts, but like, only five of them πŸ“

🌈 SEE ALSO 🌈

  • docker-swarm(1) β€” go read the parent page, bestie, it's the whole swarm family reunion πŸ¦‹

and that's the page!! this one comes to you from the Docker Community, dated Oct 2026, and it's filed under DOCKER(1) in the Docker User Manuals. mwah. take care of your swarm and it'll take care of you πŸ’–βœ¨πŸŽ€

πŸ“¦ where this page comes from