Skip to main content

Configuration

The Esper CLI uses profiles to manage multiple environments.

Profile management​

Create profiles for different environments:

# Cloud deployment
esper profile add cloud --api-base https://api.esperr.com --tenant-id <tenant-id>

# Self-hosted deployment
esper profile add local --api-base https://esper.internal.example

# Switch profiles
esper profile use cloud

# View current profile
esper profile show

# List all profiles
esper profile list

Tenant configuration​

Set a default tenant for a profile:

esper profile set-tenant <tenant-id>

Local state​

The Esper CLI stores configuration locally:

  • Config file: ~/.config/esper/config.json
  • Credentials file: ~/.config/esper/credentials.json

Environment variables​

Override configuration with environment variables:

  • ESPER_API_BASE - API endpoint
  • ESPER_TENANT_ID - Default tenant
  • ESPER_AUTH_TOKEN - Authentication token