Skip to main content

​
Commands

sb0 config set <key> <value>
sb0 config get [key]

​
Description

Manage configuration for the sb0 CLI, including platform API endpoints and registry settings.

​
Set Configuration

Set a configuration value: 
sb0 config set <key> <value>

​
Available Keys

  • platformApiBase - Platform API endpoint URL
  • registryBase - Container registry base URL
  • gatewayBase - Gateway API base URL

​
Examples

# Set platform API endpoint
sb0 config set platformApiBase https://api.sb0.io

# Set registry base
sb0 config set registryBase https://registry.sb0.io

# Set gateway base
sb0 config set gatewayBase https://gateway.sb0.io

​
Get Configuration

View configuration values: 
# Get all configuration
sb0 config get

# Get specific value
sb0 config get platformApiBase

​
Example Output

$ sb0 config get
platformApiBase: https://api.sb0.io
registryBase: https://registry.sb0.io
gatewayBase: https://gateway.sb0.io

​
Configuration Storage

Configuration is stored locally in: 
~/.sb0/config.json

​
Default Values

If not explicitly set, the CLI uses default platform endpoints: 
{
  "platformApiBase": "https://api.sb0.io",
  "registryBase": "https://registry.sb0.io",
  "gatewayBase": "https://gateway.sb0.io"
}

​
When to Use Config

You typically don’t need to modify configuration unless:
  • Using a custom deployment - Self-hosted platform
  • Testing against staging - Non-production environment
  • Enterprise setup - Custom endpoints
  • Troubleshooting - Debugging connection issues

​
Reset to Defaults

To reset configuration to defaults, remove the config file: 
rm ~/.sb0/config.json
The CLI will recreate it with defaults on next use.

​
Common Use Cases

​
Switch to Staging Environment

sb0 config set platformApiBase https://staging.sb0.io
sb0 config set registryBase https://staging-registry.sb0.io
sb0 config set gatewayBase https://staging-gateway.sb0.io

​
Switch Back to Production

sb0 config set platformApiBase https://api.sb0.io
sb0 config set registryBase https://registry.sb0.io
sb0 config set gatewayBase https://gateway.sb0.io

​
View Current Environment

sb0 config get platformApiBase

​
Configuration Priority

Configuration sources (highest to lowest priority):
  1. Explicitly set values - Via sb0 config set
  2. Environment variables - If supported
  3. Default values - Built into CLI

​
Common Issues

​
Invalid URL

Error: Invalid URL format
Solution: Ensure the URL includes the protocol: 
# Correct
sb0 config set platformApiBase https://api.example.com

# Incorrect
sb0 config set platformApiBase api.example.com

​
Permission Denied

Error: Could not write config
Solution: Ensure you have write permissions: 
mkdir -p ~/.sb0
chmod 700 ~/.sb0

​
Next Steps