# docker pass set

**Descripción:** Establece un secreto

**Uso:** `docker pass set id[=value] [flags]`





> [!NOTE]

> **Experimental**
>
> Este comando es experimental. Las funciones experimentales están destinadas a pruebas y comentarios, ya que su funcionalidad o diseño pueden cambiar entre versiones sin previo aviso o eliminarse por completo en una versión futura.
> 




## Descripción

Almacena un secreto en el llavero (keychain) local del sistema operativo. El valor del secreto se puede
proporcionar en línea (NOMBRE=VALOR) o canalizar a través de STDIN.


## Opciones

| Opción                                                        | Predeterminado                                        | Descripción                                                                                                                                    |
| ------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|  | `--metadata` |  |  Metadatos clave=valor que no son sensibles (se pueden repetir) |




## Ejemplos

### Establecer un secreto:
docker pass set POSTGRES_PASSWORD=my-secret-password

### O pasar el secreto a través de STDIN:
echo my-secret-password > pwd.txt
cat pwd.txt | docker pass set POSTGRES_PASSWORD

### Establecer un secreto con metadatos:
docker pass set POSTGRES_PASSWORD=my-secret-password --metadata owner=alice --metadata expiry=2027-03-01

### O pasar un payload JSON con secreto y metadatos a través de STDIN:
echo '{"secret":"my-secret-password","metadata":{"owner":"alice"}}' | docker pass set POSTGRES_PASSWORD