dotset link
Connect your local project to your dotset cloud dashboard for protection analytics.
Usage
dotset link <project-id> --token <api-token>
Options
| Option | Description | Required |
|---|
-t, --token <token> | API token from dashboard | Yes |
--api-url <url> | Custom API URL (self-hosted) | No |
Getting Your Token
- Log in to app.dotsetlabs.com
- Open your project
- Go to API Tokens tab
- Click New Token and copy it
Tokens are only shown once. Store them securely.
Example
# Link project
dotset link proj_abc123 --token dss_xxxxx
# Verify connection
dotset status
What Happens
When linked, dotset run automatically sends anonymized telemetry to your dashboard:
- Command executed (e.g., “npm start”)
- Secrets count loaded
- Exposures blocked (secret key names only, never values)
- Mode used (detect/redact/block)
- Duration and exit code
No secret values are ever sent to the cloud. Only metadata about protection events.
| Command | Description |
|---|
dotset unlink | Disconnect from cloud |
dotset status | Show connection status |
Disable Telemetry
To run a command without reporting:
dotset run --no-telemetry -- npm start