Documentación La línea de comandos sc

Un comando analiza una imagen. Otros dos muestran el informe y lo descargan.

Instalación

  • macOS

    Intel y Apple silicon. Ejecútalo en Terminal.

    curl -fsSL https://scancontainer.com/install.sh | sh
  • Linux

    x86-64 y ARM64. Cualquier distribución.

    curl -fsSL https://scancontainer.com/install.sh | sh
  • Windows

    Windows 10 y 11. Ejecútalo en PowerShell.

    irm https://scancontainer.com/install.ps1 | iex

El instalador detecta tu sistema, descarga un único fichero llamado sc y lo añade a tu PATH. No necesita nada más: ni Docker ni ningún runtime.

Abre una terminal nueva y comprueba que funciona.

sc version

Entrar

sc login      # Opens the browser to sign in
sc whoami     # Shows the account and the plan
sc logout     # Removes the session from this machine

En una máquina sin navegador, como un runner de CI, usa un token de acceso. Ponlo en la variable de entorno SC_TOKEN y sc lo usa sin preguntar.

Analizar una imagen

Pasa a sc image el nombre de la imagen, igual que se lo darías a docker pull.

sc image nginx:latest                          # A public image
sc image myapp:1.4                             # An image you have just built
sc image registry.example.com/team/myapp:1.4   # An image in a private registry
sc image ./myapp.tar                           # A file made with docker save
  • Si la imagen está en tu máquina, se envía desde ahí. Si no, scancontainer la descarga del registro.
  • Con un registro privado, sc lee la imagen con el acceso que Docker ya tiene en tu máquina. La contraseña de tu registro nunca se envía a scancontainer.
  • La imagen se borra al terminar el análisis.

Lo que ves

El análisis termina con un veredicto, los arreglos por orden de importancia y el enlace al informe.

$ sc image myapp:1.4

  myapp:1.4

  Almost ready. Fix 2 things first.

  1. Update the base image
     node:18 no longer gets security patches.
     FROM node:22-alpine

  2. Take the .env out of the image
     It was copied in layer 5.
     echo ".env" >> .dockerignore

  14 low-risk notes can wait.

  Report     https://platform.scancontainer.com/reports/r_8f3k2a
  Download   sc download r_8f3k2a --format pdf

Opciones

OpciónQué hace
--fail-on <level>Termina con el código de salida 1 cuando hay un hallazgo de este nivel o superior: critical, high, medium o low. Sirve para parar un pipeline.
--format <format>Muestra el resultado como text, json o sarif. Por defecto, text.
--output <file>Escribe el resultado en un fichero en vez de en la terminal.
--no-waitLanza el análisis y vuelve al momento con el ID del informe.
--quietMuestra solo el veredicto y el enlace al informe.
--helpMuestra la ayuda de cualquier comando.

Fichero de ajustes

Para no repetir opciones, ponlas en un fichero llamado .sc.yml en la carpeta donde ejecutas sc. Las opciones de la línea de comandos mandan sobre el fichero.

# .sc.yml
fail-on: high        # Same as --fail-on high
format: text         # text, json or sarif
quiet: false

Salida para otras herramientas

Con el formato json, sc muestra los mismos datos que devuelve la API, listos para jq o para tus propios scripts.

sc image myapp:1.4 --format json
{
  "id": "r_8f3k2a",
  "target": "myapp:1.4",
  "created": "2026-11-17T10:42:00Z",
  "verdict": "almost_ready",
  "findings": {"critical": 0, "high": 2, "medium": 0, "low": 14},
  "fix_first": [
    {"title": "Update the base image", "fix": "FROM node:22-alpine"}
  ],
  "url": "https://platform.scancontainer.com/reports/r_8f3k2a"
}

Ver tus informes

sc reports                  # Lists your latest reports
sc report last              # Shows the latest report in the terminal
sc report r_8f3k2a          # Shows one report by its ID
sc report r_8f3k2a --open   # Opens it in the browser
$ sc reports

ID         DATE               TARGET          VERDICT
r_8f3k2a   2026-11-17 10:42   myapp:1.4       Almost ready
r_7c1m9d   2026-11-16 18:05   nginx:latest    Ready
r_5t0q2x   2026-11-14 09:30   api:2.0         Not ready

Descargar un informe

sc download last --format pdf                         # Saves the latest report as PDF
sc download r_8f3k2a --format json                    # Saves one report as JSON
sc download r_8f3k2a --format sarif --output scan.sarif   # Chooses the file name
FormatoQué te da
pdfEl informe como documento para enviar o archivar.
htmlEl informe como una sola página que se abre en cualquier navegador.
jsonTodos los hallazgos como datos, para tus propias herramientas.
sarifLos hallazgos para el análisis de código de GitHub, GitLab y Azure DevOps.
cyclonedxEl SBOM en CycloneDX.
spdxEl SBOM en SPDX.
openvexLa declaración VEX en OpenVEX.
cyclonedx-vexLa declaración VEX en CycloneDX VEX.
csafLa declaración VEX en CSAF.

Los formatos que puedes descargar dependen de tu plan. Las cuentas gratuitas reciben el informe sencillo.

Otros comandos

ComandoQué hace
sc usageMuestra los análisis usados y los que quedan este mes.
sc delete r_8f3k2aBorra un informe de tu cuenta de forma definitiva.
sc completion zshMuestra el script de autocompletado para tu shell: bash, zsh, fish o powershell.
sc updateActualiza sc a la última versión.
sc versionMuestra la versión instalada.

Códigos de salida

CódigoSignificado
0El análisis ha terminado y nada ha llegado al nivel fijado con --fail-on.
1El análisis ha terminado y al menos un hallazgo ha llegado a ese nivel.
2El análisis no se ha podido ejecutar: argumentos incorrectos, sin sesión o sin red.
3Se ha alcanzado el límite de tu plan.

Variables de entorno

VariableQué hace
SC_TOKENEl token de acceso que se usa en lugar de la sesión de sc login.
NO_COLORQuita los colores de la salida.

Recetas

# Build, scan and push only if the scan passes
docker build -t myapp:1.4 .
sc image myapp:1.4 --fail-on high && docker push registry.example.com/team/myapp:1.4

# Scan every image a compose file uses
docker compose config --images | xargs -n1 sc image

# Keep a PDF of every scan
sc image myapp:1.4 && sc download last --format pdf --output myapp-1.4.pdf

Una herramienta para imágenes y código

La misma herramienta funciona con scancontainer y con scancodebase: sc image analiza una imagen de contenedor y sc code analiza código fuente.

Si algo va mal

Lo que vesQué hacer
command not found: scAbre una terminal nueva. Si sigue sin aparecer, ejecuta el instalador otra vez.
Sin sesiónEjecuta sc login, o comprueba que SC_TOKEN está definido y no se ha revocado.
Límite alcanzadoEjecuta sc usage para ver lo que queda. El análisis se lanza cuando el límite se reinicia o cuando añades análisis.
No se puede leer la imagenRevisa el nombre y la etiqueta, y que docker pull funcione con ese mismo nombre.
No se ha podido leer parte de la imagenEl informe lo señala como hueco en vez de darlo por limpio.

Escanea la tuya antes del próximo despliegue.