'on-failure' container restart policy is set to '5'
Incident Management is now generally available! Incident Management is now generally available!
<  Back to rules search

'on-failure' container restart policy is set to '5'










By using the --restart flag in the docker run command you can specify a restart policy for how a container should or should not be restarted on exit. You should choose the on-failure restart policy and limit the restart attempts to 5.


If you indefinitely keep trying to start the container, it could possibly lead to a denial of service on the host. It could be an easy way to do a distributed denial of service attack especially if you have many containers on the same host. Additionally, ignoring the exit status of the container and always attempting to restart the container, leads to non-investigation of the root cause behind containers getting terminated. If a container gets terminated, you should investigate on the reason behind it instead of just attempting to restart it indefinitely. You should use the on-failure restart policy to limit the number of container restarts to a maximum of 5 attempts.


Execute this command: docker ps --quiet --all | xargs docker inspect --format '{{ .Id }}: RestartPolicyName={{ .HostConfig.RestartPolicy.Name }} MaximumRetryCount={{ .HostConfig.RestartPolicy.MaximumRetryCount }}'

If this command returns RestartPolicyName=always, then the system is not configured optimally. If this command returns RestartPolicyName=no or just RestartPolicyName=, then restart policies are not being used and the container would never be restarted automatically. This may be a secure option, but it is not the best option from a usability standpoint. If this command returns RestartPolicyName=on-failure, then verify that the number of restart attempts is set to 5 or less by looking at MaximumRetryCount.


If you wish a container to be automatically restarted, use docker run --detach --restart=on-failure:5 nginx


If this option is set, a container will only attempt to restart itself 5 times.

Default Value

By default, containers are not configured with restart policies.


  1. https://docs.docker.com/engine/reference/commandline/run/#restart-policies-restart

CIS Controls

Version 6

18 Application Software Security Application Software Security