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

SettingDefaultDescription
conduit.relayUrlwss://relay.conduitrelay.comRelay WebSocket URL
conduit.dashboardUrlhttps://app.conduitrelay.comDashboard URL for auth (if using account-based auth)
conduit.registrationToken(empty)Shared token for self-hosted relays with RELAY_REGISTRATION_TOKEN set
conduit.localPort3000Local port to forward relay traffic to
conduit.modeproxyproxy (forward to localhost) or watch (observe only)
conduit.autoConnecttrueAuto-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.