# docker container restart

**Descripción:** Reinicia uno o más contenedores

**Uso:** `docker container restart [OPTIONS] CONTAINER [CONTAINER...]`

**Alias:** `docker restart`








## Descripción

Reinicia uno o más contenedores


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-s`, `--signal` |  |  Señal a enviar al contenedor |

 | `-t`, `--timeout` |  |  Segundos a esperar antes de terminar abruptamente (kill) el contenedor |




## Ejemplos

```console
$ docker restart my_container
```


### Detener contenedor con señal (-s, --signal) {#signal}

El flag `--signal` envía la señal de llamada al sistema al contenedor para que finalice.
Esta señal puede ser un nombre de señal en el formato `SIG<NOMBRE>`, por ejemplo
`SIGKILL`, o un número entero sin signo que coincida con una posición en la tabla de
llamadas al sistema del kernel, por ejemplo `9`. Consulta [signal(7)](https://man7.org/linux/man-pages/man7/signal.7.html)
para conocer las señales disponibles.

La señal por defecto a utilizar está definida por el [`StopSignal`](https://github.com/opencontainers/image-spec/blob/v1.1.0/config.md) de la imagen,
que se puede establecer a través de la instrucción de Dockerfile [`STOPSIGNAL`](/reference/dockerfile/#stopsignal)
al construir la imagen, o configurarse mediante la opción
[`--stop-signal`](/reference/cli/docker/container/run/#stop-signal)
al crear el contenedor. Si no se configura ninguna señal para el contenedor,
se utiliza `SIGTERM` por defecto.

### Detener contenedor con tiempo de espera (-t, --timeout) {#timeout}

El flag `--timeout` establece el número de segundos a esperar a que el contenedor
se detenga después de enviar la señal de llamada al sistema predefinida (ver [`--signal`](#signal)).
Si el contenedor no finaliza una vez transcurrido el tiempo de espera, se le termina abruptamente por la fuerza
con una señal `SIGKILL`.

Si estableces `--timeout` en `-1`, no se aplica ningún tiempo de espera y el demonio
espera indefinidamente a que el contenedor finalice.

El tiempo de espera predeterminado se puede especificar mediante la opción [`--stop-timeout`](/reference/cli/docker/container/run/#stop-timeout)
al crear el contenedor. Si no se configura ningún valor predeterminado para el contenedor,
el demonio determina el valor predeterminado, que es de 10 segundos para contenedores Linux y
de 30 segundos para contenedores Windows.