Skip to main content
Repositories shows all repositories in the current project. Use it to turn Vidoc on or off for each repository. To add repositories, an admin connects a source code platform and imports the repositories. Refer to GitHub, GitLab, or Bitbucket.
Repository list with the options menu open

​
Repository list

The top of the page shows the number of repositories, the issues found, the repositories with automatic scans on, and the repositories with PR comments on.
  • Use Search repositories… to find a repository by name.
  • Click Filters to show only some providers, or only repositories with scanning on (Scanned only).
Each row shows the repository name, the provider, the status, and the source branch. The status can be:

​
Turn on PR reviews

When PR reviews are off, the row shows Have me watch this repo. Click it to turn on PR reviews. When PR reviews are on, the row shows an ON / off toggle. When you turn on PR reviews:
  1. Vidoc indexes the repository.
  2. On the Enterprise plan and on self-hosted installations, Vidoc then runs a first full scan of the default branch (the Source branch setting).
  3. Vidoc scans each new PR and each new commit in a PR. For all the events that start a scan, refer to Pull request reviews.
Platform differences:
  • GitLab: Vidoc creates the project webhook.
  • Bitbucket: you create the webhook in each repository by hand. Refer to Bitbucket.
You need the Developer role or higher.
Vidoc Cloud: if the organization has no active plan, Vidoc does not index the repository and does not scan PRs. The page shows a banner. An admin clicks Activate plan to open Billing.

​
Repository options

Open the options menu (⋮) of a repository.
Run scan needs the Enterprise plan on Vidoc Cloud. Included in self-hosted installations. On other plans, the menu does not show Run scan.
You can also scan a local copy of a repository with the CLI. Refer to Scanning with the CLI.

​
Repository page

The repository page needs the Enterprise plan on Vidoc Cloud. Included in self-hosted installations. On other plans, a click on a repository opens Pull requests.
Click a repository to open its findings. The page is the same as Findings, with these differences:
  • The page shows only the findings of this repository.
  • Use Branch to show the findings of one scanned branch. By default, the page shows the source branch.
  • If the source branch was never scanned, the page tells you.
  • Scan Repository shows the commands to scan the repository with the CLI or with GitHub Actions. Refer to CI/CD.