CLI Configuration

The Conduit CLI reads its relay URL from three places, in order of priority:

  1. --relay flag on the command line
  2. CONDUIT_RELAY_URL environment variable
  3. ~/.conduit/projects.json global config
  4. Default: wss://relay.conduitrelay.com

Point the CLI at your relay

One-time flag:

conduit start --relay wss://relay.yourdomain.com --port 3000

Environment variable (add to your shell profile):

export CONDUIT_RELAY_URL=wss://relay.yourdomain.com

Persistent global config (coming soon via conduit config set):

# Stored in ~/.conduit/projects.json
conduit config set relay-url wss://relay.yourdomain.com

Auth on self-hosted relays

If your relay runs with RELAY_AUTH_REQUIRED=false (open relay), no login is needed — just run conduit start.

If your relay uses RELAY_REGISTRATION_TOKEN, pass it via environment variable:

export CONDUIT_REGISTRATION_TOKEN=your-shared-secret
conduit start --port 3000

Dashboard URL

If you also run the Conduit dashboard self-hosted, you can point conduit login at it:

conduit login --dashboard https://dashboard.yourdomain.com

Or set it persistently:

export CONDUIT_DASHBOARD_URL=https://dashboard.yourdomain.com

Full example

# .bashrc / .zshrc
export CONDUIT_RELAY_URL=wss://relay.yourdomain.com
export CONDUIT_REGISTRATION_TOKEN=mysecret  # if using token auth
 
# Then in any project:
conduit start --port 3000