# Instalar Docker Scout


El plugin de la CLI de Docker Scout viene preinstalado con Docker Desktop.

Si ejecutas Docker Engine sin Docker Desktop,
Docker Scout no viene preinstalado,
pero puedes instalarlo como un binario independiente.

## Script de instalación

Para instalar la última versión del plugin, ejecuta los siguientes comandos:

```console
$ curl -fsSL https://raw.githubusercontent.com/docker/scout-cli/main/install.sh -o install-scout.sh
$ sh install-scout.sh
```

> [!NOTE]
>
> Examina siempre los scripts descargados de internet antes de ejecutarlos
> localmente. Antes de realizar la instalación, familiarízate con los posibles riesgos y
> limitaciones del script de conveniencia.

## Instalación manual

**Linux**



1. Descarga la última versión desde la [página de lanzamientos](https://github.com/docker/scout-cli/releases).
2. Crea un subdirectorio llamado `scout` bajo `$HOME/.docker`.

   ```console
   $ mkdir -p $HOME/.docker/scout
   ```

3. Extrae el archivo y mueve el binario `docker-scout` al directorio `$HOME/.docker/scout`.
4. Haz que el binario sea ejecutable: `chmod +x $HOME/.docker/scout/docker-scout`.
5. Agrega el subdirectorio `scout` a tu archivo `.docker/config.json` como un directorio de plugins:

   ```json
   {
     "cliPluginsExtraDirs": ["/home/<USER>/.docker/scout"]
   }
   ```

   Sustituye `<USER>` por tu nombre de usuario en el sistema.

   > [!NOTE]
   > La ruta para `cliPluginsExtraDirs` debe ser una ruta absoluta.

**macOS**



1. Descarga la última versión desde la [página de lanzamientos](https://github.com/docker/scout-cli/releases).
2. Crea un subdirectorio llamado `scout` bajo `$HOME/.docker`.

   ```console
   $ mkdir -p $HOME/.docker/scout
   ```

3. Extrae el archivo y mueve el binario `docker-scout` al directorio `$HOME/.docker/scout`.
4. Haz que el binario sea ejecutable:

   ```console
   $ chmod +x $HOME/.docker/scout/docker-scout
   ```

5. Autoriza el binario para que sea ejecutable en macOS:

   ```console
   $ xattr -d com.apple.quarantine $HOME/.docker/scout/docker-scout
   ```

6. Agrega el subdirectorio `scout` a tu archivo `.docker/config.json` como un directorio de plugins:

   ```json
   {
     "cliPluginsExtraDirs": ["/Users/<USER>/.docker/scout"]
   }
   ```

   Sustituye `<USER>` por tu nombre de usuario en el sistema.

   > [!NOTE]
   > La ruta para `cliPluginsExtraDirs` debe ser una ruta absoluta.

**Windows**



1. Descarga la última versión desde la [página de lanzamientos](https://github.com/docker/scout-cli/releases).
2. Crea un subdirectorio llamado `scout` bajo `%USERPROFILE%\.docker`.

   ```console
   % mkdir %USERPROFILE%\.docker\scout
   ```

3. Extrae el archivo y mueve el binario `docker-scout.exe` al directorio `%USERPROFILE%\.docker\scout`.
4. Agrega el subdirectorio `scout` a tu archivo `.docker\config.json` como un directorio de plugins:

   ```json
   {
     "cliPluginsExtraDirs": ["C:\\Users\\<USER>\\.docker\\scout"]
   }
   ```

   Sustituye `<USER>` por tu nombre de usuario en el sistema.

   > [!NOTE]
   > La ruta para `cliPluginsExtraDirs` debe ser una ruta absoluta.



## Imagen de contenedor

El plugin de la CLI de Docker Scout también está disponible como una [imagen de contenedor](https://hub.docker.com/r/docker/scout-cli).
Utiliza `docker/scout-cli` para ejecutar comandos `docker scout` sin instalar el plugin de la CLI en tu host.

```console
$ docker run -it \
  -e DOCKER_SCOUT_HUB_USER=<your Docker Hub user name> \
  -e DOCKER_SCOUT_HUB_PASSWORD=<your Docker Hub PAT>  \
  docker/scout-cli <command>
```

## GitHub Action

El plugin de la CLI de Docker Scout también está disponible como una [GitHub Action](https://github.com/docker/scout-action).
Puedes utilizarla en tus flujos de trabajo de GitHub para analizar automáticamente las imágenes y evaluar el cumplimiento de las políticas con cada envío (push).

Docker Scout también se integra con muchas otras herramientas de CI/CD, como Jenkins, GitLab y Azure DevOps.
Obtén más información sobre las [integraciones](/scout/integrations/) disponibles para Docker Scout.

