Documentation Get started with scancontainer
Five ways to scan an image: the browser, the command line, a docker push, your CI pipeline and the API. All of them end in the same report.
Choose how to scan
- No account
Browser
Type the name on the home page. Good for trying it on one image.
- Free account
Command line
Install sc and scan with one command. Good for daily work on your own machine.
- Free account
docker push
Use the tool you already have. Good for machines where you cannot install anything.
- Skipper and above
CI pipeline
Check every build before it ships and stop the pipeline on serious findings.
- Fleet
API
Start scans and read reports from your own tools and dashboards.
- All plans
Reports
Read them in the browser or the terminal, and download them as PDF, JSON or SARIF.
How a scan works
- You send the imageFrom the browser, the command line, a push, your pipeline or the API.
- We read every fileNothing is executed. The analysis runs in an isolated worker in the European Union.
- You get a verdictReady, almost ready or not ready, with the fixes in order of importance.
- What you sent is deletedOnly the report stays in your account, until you delete it.
Quick start
Install the command line tool, sign in and run your first scan. It takes about a minute.
curl -fsSL https://scancontainer.com/install.sh | sh
sc login
sc image nginx:latestThe result is printed in your terminal and the report is saved in your account.
On Windows, use the PowerShell installer from the command line page.
Scan from the browser
- Open the home page and type the name of the image, with its tag, in the box.
- For a private image, choose Private registry and enter the image with a login that can pull it.
- To scan a file from your device, choose Upload a file and pick it.
- Press the button. The report opens when the analysis ends.
Access tokens
An access token lets the command line, your CI pipeline and the API act for your account without your password.
- Create it in the platform, in your account settings.
- It is shown only once. Keep it in a password manager or as a secret in your CI system.
- You can revoke it at any time. Scans that use a revoked token are rejected.
Limits
- Without an account: 1 scan a day.
- Free account: 5 scans a day, up to 30 a month.
- Paid plans: a monthly pool of scans. Extra scans are billed per 100.
Your data
The images you send are deleted when the analysis ends. Only the report is kept. Everything is stored and processed in the European Union: Spain is the primary region and Germany the secondary one.
Common questions
Do I need an account?
Not for the first try: the browser gives you 1 scan a day without an account. The command line, the push and the scan history need a free account.
Do I have to install anything?
No. You can scan from the browser or with a docker push. The sc command line is optional and is a single file.
Is the command line free?
Yes. It works with a free account, within the limits of your plan.
Can I scan something private?
Yes. The command line reads a private image with the access Docker already has on your machine. From the browser, choose Private registry and enter a login that can pull it.
Can I download the report?
Yes: from your account, with sc download or through the API. The formats depend on your plan.
Where does my data go?
To servers in the European Union: Spain is the primary region and Germany the secondary one. What you send is deleted when the analysis ends.