Skip to main content

​
Cloud Connection

Connect your projects to dotset cloud for analytics, team sync, and centralized security policies.

​
Commands

CommandDescription
dotset link <id> --token <t>Connect project to cloud
dotset shield unlinkDisconnect from cloud
dotset shield statusShow connection status
dotset shield syncSync security policies
Connect a local project to your cloud dashboard. 
dotset link <project-id> --token <api-token>

​
Prerequisites

  1. Create a project in the dashboard
  2. Generate an API token from project settings
  3. Copy the project ID and token

​
Options

OptionDescription
--token, -tAPI token from dashboard (required)
--api-urlCustom API URL for self-hosted

​
Output

$ dotset link abc123 --token dss_xxxx...

Connecting to dotset cloud...
✓ Project linked successfully

Protection events will now be sent to your dashboard.
Run commands with "dotset shield run" to start tracking.
Disconnect the current project from cloud. 
dotset shield unlink
This removes the .dotset/project.json configuration file.

​
dotset shield status

Check the current cloud connection status. 
dotset shield status

​
Output

$ dotset shield status

✓ Linked to cloud
  Project ID: abc123
  API URL: https://api.dotsetlabs.com

​
dotset shield sync

Fetch the latest security policies from the cloud. 
dotset shield sync
Policies are cached locally and automatically used during dotset shield run.

​
Cloud Features

After connecting, you get:
  • Protection Analytics — View secret exposure stats in your dashboard
  • Centralized Policies — Define regex patterns and blocklists in the dashboard
  • Team Collaboration — Share projects with team members
  • Audit Logs — Track all protection events

​
Configuration Storage

Link configuration is stored in .dotset/project.json (project-local): 
{
  "projectId": "abc123",
  "apiToken": "dss_xxxx..."
}
Note: Add .dotset/ to your .gitignore to keep tokens out of version control.