# docker node rm

**Descripción:** Elimina uno o más nodos del swarm

**Uso:** `docker node rm [OPTIONS] NODE [NODE...]`

**Alias:** `docker node remove`






**Orquestador:** Swarm

## Descripción

Elimina los nodos especificados de un swarm.

> [!NOTE]
> Este es un comando de administración de clústeres y debe ejecutarse en un nodo
> administrador de swarm. Para obtener información sobre los administradores y los nodos de trabajo (workers), consulta la
> [sección del modo Swarm](/engine/swarm/) en la
> documentación.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `-f`, `--force` |  |  Fuerza la eliminación de un nodo del swarm |




## Ejemplos


### Eliminar un nodo detenido del swarm

```console
$ docker node rm swarm-node-02

Node swarm-node-02 removed from swarm
```

### Intentar eliminar un nodo en ejecución del swarm

Elimina los nodos especificados del swarm, pero solo si están en estado "down" (caído). Si intentas eliminar un nodo activo, recibirás un error:

```console
$ docker node rm swarm-node-03

Error response from daemon: rpc error: code = 9 desc = node swarm-node-03 is not
down and can't be removed
```

### Eliminar a la fuerza un nodo inaccesible del swarm (--force) {#force}

Si pierdes el acceso a un nodo de trabajo (worker) o necesitas apagarlo porque se ha visto comprometido o no se comporta como se espera, puedes utilizar la opción `--force`. Esto puede causar errores transitorios o interrupciones, dependiendo del tipo de tarea que se ejecute en el nodo.

```console
$ docker node rm --force swarm-node-03

Node swarm-node-03 removed from swarm
```

Un nodo administrador debe ser degradado a un nodo de trabajo (mediante `docker node demote`) antes de que puedas eliminarlo del swarm.