Docker start configuration behavior and restart policy

To configure the start configuration behavior or the restart policy for a container (both of them), use the --restart flag when using the docker run command. The value of the --restart flag can be any of the following:

• Do not automatically restart the container. (the default): no
• Restart the container if it exits due to an error, which manifests as a non-zero exit code: on-failure
• Restart the container unless it is explicitly stopped or Docker itself is stopped or restarted: unless-stopped
• Always restart the container if it stops: always

The following example starts a Redis container and configures it to always restart unless it is explicitly stopped or Docker is restarted:

$ docker run -dit --restart unless-stopped redis With docker inspect CONTAINER you can verify RestartPolicy configuration.

To update restart policy execute:

docker update --restart=always CONTAINER_ID|CONTAINER_NAME

If the container is started with “--rm” flag, you cannot update the restart policy for it. The AutoRemove and RestartPolicy are mutually exclusive for the container.

docker inspect -f "Template:.HostConfig.RestartPolicy" CONTAINER_NAME

docker update --restart=no $(docker container ls -aq)

docker inspect -f "Template:.HostConfig.RestartPolicy" $(docker ps -a -q)

Related commands

• docker inspect
• docker-compose.yml
• HEALTHCHECK
• systemd and service
• docker ps
• docker start

See also

• docker inspect
• Docker: docker-compose, Docker Desktop, Docker Scout, Docker Swarm, Docker Volumes, Docker images management, docker network, docker inspect, docker volume inspect, Dockerfile, Docker Engine release notes,docker kill, moby, Docker-in-Docker, docker context, buildx, docker tag, docker system prune, Docker Hub, hub-tool, /etc/docker/daemon.json, hostconfig.json, dockerd, logs, Docker logging, Backup, docker service, depends on, --dns, --filter, --mount, docker login, docker build, apt remove docker.io, .dockerignore, docker context ls | docker-machine, .docker/, PWD, $HOME/.docker/config.json, Docker ID, --env-file, docker --help
• service, service --status-all, /etc/inittab, service ssh restart

https://stackoverflow.com/questions/43108227/is-it-possible-to-show-the-restart-policy-of-a-running-docker-container

https://docs.docker.com/engine/reference/commandline/update/

docker update --restart=always 90bf248337dc