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[1] you can verify RestartPolicy configuration.
To update restart policy execute:
docker update[2]--restart=always CONTAINER_ID|CONTAINER_NAME[3]- 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 "{{ .HostConfig.RestartPolicy }}" CONTAINER_NAME
Related commands
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
Advertising:
