docker-container-update - Man Page

• Update restart policy to apply when a specific container exits: docker [update|container update] --restart always|no|on-failure|unless-stopped container_name
• Update the policy to restart up to three times a specific container when it exits with non-zero exit status: docker [update|container update] --restart on-failure:3 container_name
• Update the number of CPUs available to a specific container: docker [update|container update] --cpus count container_name
• Update the memory limit in [M]egabytes for a specific container: docker [update|container update] [-m|--memory] limitM container_name
• Update the maximum number of process IDs allowed inside a specific container (use -1 for unlimited): docker [update|container update] --pids-limit count container_name
• Update the amount of memory in [M]egabytes a specific container can swap to disk (use -1 for unlimited): docker [update|container update] --memory-swap limitM container_name

tldr.sh

docker container update [Options] CONTAINER [CONTAINER...]

The docker container update command dynamically updates container configuration. You can use this command to prevent containers from consuming too many resources from their Docker host.  With a single command, you can place limits on a single container or on many. To specify more than one container, provide space-separated list of container names or IDs.

Memory limit (format: <number>[<unit>], where unit = b, k, m or g)

Note that the memory should be smaller than the already set swap memory limit. If you want update a memory limit bigger than the already set swap memory limit, you should update swap memory limit at the same time. If you don't set swap memory limit on docker create/run but only memory limit, the swap memory is double the memory limit.

The following sections illustrate ways to use this command.

$ docker container update --cpu-shares 512 abebf7571666

$ docker container update --cpu-shares 512 -m 300M abebf7571666 hopeful_morse

$ docker container update --restart=on-failure:3 abebf7571666 hopeful_morse

--blkio-weight=0 Block IO (relative weight), between 10 and 1000, or 0 to disable (default 0)

--cpu-period=0 Limit CPU CFS (Completely Fair Scheduler) period

--cpu-quota=0 Limit CPU CFS (Completely Fair Scheduler) quota

--cpu-rt-period=0 Limit the CPU real-time period in microseconds

--cpu-rt-runtime=0 Limit the CPU real-time runtime in microseconds

-c, --cpu-shares=0 CPU shares (relative weight)

--cpus= Number of CPUs

--cpuset-cpus="" CPUs in which to allow execution (0-3, 0,1)

--cpuset-mems="" MEMs in which to allow execution (0-3, 0,1)

-m, --memory=0 Memory limit

--memory-reservation=0 Memory soft limit

--memory-swap=0 Swap limit equal to memory plus swap: -1 to enable unlimited swap

--pids-limit=0 Tune container pids limit (set -1 for unlimited)

--restart="" Restart policy to apply when a container exits

docker-container(1)

docker-container(1).