sb0 config

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):

Explicitly set values - Via sb0 config set
Environment variables - If supported
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

​Commands

​Description

​Set Configuration

​Available Keys

​Examples

​Get Configuration

​Example Output

​Configuration Storage

​Default Values

​When to Use Config

​Reset to Defaults

​Common Use Cases

​Switch to Staging Environment

​Switch Back to Production

​View Current Environment

​Configuration Priority

​Common Issues

​Invalid URL

​Permission Denied

​Next Steps

​Related