VS Code Extension Configuration
The Conduit VS Code extension has settings for pointing at a self-hosted relay. Open VS Code settings (Cmd+,) and search for “Conduit”.
Settings
| Setting | Default | Description |
|---|---|---|
conduit.relayUrl | wss://relay.conduitrelay.com | Relay WebSocket URL |
conduit.dashboardUrl | https://app.conduitrelay.com | Dashboard URL for auth (if using account-based auth) |
conduit.registrationToken | (empty) | Shared token for self-hosted relays with RELAY_REGISTRATION_TOKEN set |
conduit.localPort | 3000 | Local port to forward relay traffic to |
conduit.mode | proxy | proxy (forward to localhost) or watch (observe only) |
conduit.autoConnect | true | Auto-connect when a workspace opens |
Configure via settings.json
Add to your workspace .vscode/settings.json to share config with your team:
{
"conduit.relayUrl": "wss://relay.yourdomain.com",
"conduit.localPort": 3000,
"conduit.registrationToken": "your-shared-secret"
}
Or to your user settings.json (Cmd+Shift+P → “Open User Settings JSON”) for a personal default:
{
"conduit.relayUrl": "wss://relay.yourdomain.com"
}
Open relay (no auth)
If your relay runs with RELAY_AUTH_REQUIRED=false, you don’t need to set registrationToken. Just update conduit.relayUrl and you’re done.
Registration token auth
If your relay uses RELAY_REGISTRATION_TOKEN, set it in VS Code settings:
{
"conduit.relayUrl": "wss://relay.yourdomain.com",
"conduit.registrationToken": "your-shared-secret"
}
The extension sends this token when connecting. It is stored in VS Code’s settings — use workspace settings only if you’re comfortable with it being in source control, or user settings to keep it local to your machine.