Skip to main content
The CLI requires authentication to scan your code and sync results with your Vidoc project.

​
Get Your Token

  1. Go to app.vidocsecurity.com
  2. Select your project
  3. Navigate to Settings → API Keys
  4. Click “Create API Key”
  5. Copy the token
Store your token securely. Don’t commit it to version control.

​
Login

​
Interactive Login

vidoc login
You’ll be prompted to enter your token.

​
Direct Login

Provide the token as an argument: 
vidoc login <your-token>

​
Single-Tenant Installations

For self-hosted Vidoc instances, specify the API URL: 
vidoc login --url https://your-vidoc-instance.com <your-token>

​
Profiles

Profiles let you manage multiple Vidoc configurations (e.g., different projects or environments).

​
Create a Named Profile

vidoc login --profile work <your-token>
vidoc login --profile personal <other-token>

​
List Profiles

vidoc config list-profiles

​
Switch Profile

vidoc config set-profile work

​
Create Empty Profile

vidoc config create-profile staging

​
Delete Profile

vidoc config delete-profile old-project

​
View Current Configuration

See your current authentication status and settings: 
vidoc config show

​
CI/CD Authentication

For CI/CD pipelines, pass the token directly: 
vidoc ci --token $VIDOC_TOKEN
Or use the --token flag with scan: 
vidoc scan --token $VIDOC_TOKEN
See CI/CD Integration for pipeline examples.

​
Troubleshooting

​
”Invalid token”

  1. Verify the token was copied correctly
  2. Check for extra whitespace
  3. Ensure the token hasn’t been revoked in the dashboard

​
”Unauthorized”

The token may be associated with a deleted project. Create a new token in an active project.

Installation

Install the CLI

Scanning

Run scans

API Keys

Manage tokens

CI/CD

CI/CD integration