As mentioned in the installation guide, ScanCode.io offers a web application to create and manage your projects from a browser. You’ll get access to this visual interface when you successfully install ScanCode.io locally.
When you open the web application for the first time, the home screen will appear. From this screen, you’ll be able to create a new project, search your existing projects, view or download scan results, access documentation, and more.
Creating a New Project
Creating a project is the first step that needs to be performed before you can start using ScanCode.io. There are two “New Project” buttons on the home screen, as shown in the previous screenshot. To create a new project, click on either button, and you will be directed to the “Create a Project” page.
As shown above, creating a project involves filling in the following input fields:
To create a project, you must provide a unique name for the new project.
A project name can’t be changed or edited once the project has been created.
You can upload files available on your machine or add links to desired input files, such as package archives or Docker images, as the input to your project. If you are providing more than one URL as the project input, make sure to add one URL per line.
Docker images can be provided as inputs to be fetched using the
docker://docker-reference syntax in the “Download URLs” field.
Use the drop-down list to select one of the available pipelines depending on your use-case. When you add a pipeline, you can check the “Execute pipeline now” checkbox, which will add and execute the selected pipeline in one operation.
If you’re not sure of which pipeline to select, refer to the pipelines details on the right pane of the “Create a Project” page, as shown above.
You can still create a new project while leaving the Inputs and Pipeline fields blank; however, it’s mandatory to provide a project Name!
Once successfully created, you can later add any needed inputs and pipelines to your project by clicking the “Add inputs” and “Add pipeline” buttons.
You will not be able to add any extra inputs once a pipeline has been run on the project. However, you still can add and run extra pipelines as needed!
Within each project, you can view your project details, review the results of the pipeline execution, or download the output files.
Please refer to the Output Files page for more details about your scan results.
The project settings form provides a convenient interface for editing essential project details and adding relevant notes. With this form, you have the ability to modify the project name, as well as include any additional notes you deem necessary.
In addition to managing project information, the form also offers configuration options that are related to the extraction process. You can specify a list of items to be ignored during pipeline execution, ensuring that only relevant content is considered. Furthermore, you have the option to customize the attribution template according to your specific requirements.
To generate the project configuration file
scancode-config.yml, navigate to the
Project Settings UI and click on the Config file link in the left section under
Archive a Project
After a project is complete, you may want to archive it to prevent any further modification to that project.
Archiving projects also makes navigating existing projects easier as the archived projects are hidden by default from the project list.
Selected Project workspace directories can be removed during the archive operation.
The project results are stored in the database and available to generate outputs at any time.
A project cannot be archived if one of its related run is queued or already running.
Reset a Project
The reset allows to wipe all database entries and all data on disks related to a project while keeping the input/ files. It can be used to re-run pipelines on a clean slate of the project without having to re-upload input files.
Delete a Project
If any of your projects is no longer needed, you can delete it from the project’s details page. Deleting old projects also makes navigating existing projects easier. Simply to delete any project, click on the trash icon under the project’s name.
Projects get permanently deleted and cannot be restored.
When searching on objects list views, you can use a powerful search syntax to refine your queries and find exactly what you’re looking for. This guide will walk you through the search syntax and provide examples to help you get started.
Single Term: Enter a single word to search for exact matches.
Quoted Phrases: Use double quotes to search for exact phrases.
Field Searches: Specify fields to narrow down your search. Use
field_name:followed by your search term.
Negation: Use a hyphen (-) before a field name to exclude results.
Lookup Types: Use lookup types to perform specific searches.
=: Exact match
^: Starts with
$: Ends with
>: Greater than
<: Less than
Multiple queries are combined with the
Here are some examples of advanced searches:
Search for Resources:
Find resources by name and license_expression:
Find resources by path ending: