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 | shLinux
x86-64 y ARM64. Cualquier distribución.
curl -fsSL https://scancontainer.com/install.sh | shWindows
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 versionEntrar
sc login # Opens the browser to sign in
sc whoami # Shows the account and the plan
sc logout # Removes the session from this machineEn 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ón | Qué 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-wait | Lanza el análisis y vuelve al momento con el ID del informe. |
--quiet | Muestra solo el veredicto y el enlace al informe. |
--help | Muestra 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: falseSalida 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| Formato | Qué te da |
|---|---|
pdf | El informe como documento para enviar o archivar. |
html | El informe como una sola página que se abre en cualquier navegador. |
json | Todos los hallazgos como datos, para tus propias herramientas. |
sarif | Los hallazgos para el análisis de código de GitHub, GitLab y Azure DevOps. |
cyclonedx | El SBOM en CycloneDX. |
spdx | El SBOM en SPDX. |
openvex | La declaración VEX en OpenVEX. |
cyclonedx-vex | La declaración VEX en CycloneDX VEX. |
csaf | La declaración VEX en CSAF. |
Los formatos que puedes descargar dependen de tu plan. Las cuentas gratuitas reciben el informe sencillo.
Otros comandos
| Comando | Qué hace |
|---|---|
sc usage | Muestra los análisis usados y los que quedan este mes. |
sc delete r_8f3k2a | Borra un informe de tu cuenta de forma definitiva. |
sc completion zsh | Muestra el script de autocompletado para tu shell: bash, zsh, fish o powershell. |
sc update | Actualiza sc a la última versión. |
sc version | Muestra la versión instalada. |
Códigos de salida
| Código | Significado |
|---|---|
0 | El análisis ha terminado y nada ha llegado al nivel fijado con --fail-on. |
1 | El análisis ha terminado y al menos un hallazgo ha llegado a ese nivel. |
2 | El análisis no se ha podido ejecutar: argumentos incorrectos, sin sesión o sin red. |
3 | Se ha alcanzado el límite de tu plan. |
Variables de entorno
| Variable | Qué hace |
|---|---|
SC_TOKEN | El token de acceso que se usa en lugar de la sesión de sc login. |
NO_COLOR | Quita 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.pdfUna 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 ves | Qué hacer |
|---|---|
| command not found: sc | Abre una terminal nueva. Si sigue sin aparecer, ejecuta el instalador otra vez. |
| Sin sesión | Ejecuta sc login, o comprueba que SC_TOKEN está definido y no se ha revocado. |
| Límite alcanzado | Ejecuta 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 imagen | Revisa el nombre y la etiqueta, y que docker pull funcione con ese mismo nombre. |
| No se ha podido leer parte de la imagen | El informe lo señala como hueco en vez de darlo por limpio. |