Profiles and Overrides

You can use multiple profiles with Clever Tools, all stored in the configuration file. The active profile is the first one in the list and is used for all commands. Each profile contains your authentication data and an optional set of overrides for custom Clever Cloud deployments (API host, Console URL, etc.).

Create and use multiple profiles

By default, clever login stores a profile under the default alias. To manage multiple accounts, log in with explicit aliases:

clever login --alias personal
clever login --alias work

List and inspect profiles (the active one is marked):

clever profile list

Switch to another profile:

clever profile switch --alias work

Log out from a specific profile:

clever logout --alias personal

Overrides

Overrides are stored per profile and are applied only when that profile is active. You can set them at login time:

clever login --alias staging \
  --api-host https://api.clever-cloud.com \
  --console-url https://console.clever-cloud.com \
  --auth-bridge-host https://api-bridge.clever-cloud.com \
  --ssh-gateway ssh@sshgateway-clevercloud-customers.services.clever-cloud.com \
  --oauth-consumer-key MY_KEY \
  --oauth-consumer-secret MY_SECRET

Resolution order for configuration values:

1. Defaults provided by Clever Tools
2. Active profile overrides
3. Environment variables

To change overrides later, log in again with the same alias. The profile will be replaced and becomes active.

Special cases

• If CLEVER_TOKEN and CLEVER_SECRET are set, Clever Tools injects a virtual $env profile that becomes active. You cannot switch or logout while $env is active; unset those environment variables first.
• The alias $env is reserved and cannot be used with clever login --alias.
• If there is only one stored profile, clever profile switch fails. With exactly two profiles and no --alias, it switches to the other one; with more than two, it prompts you to pick a profile.
• Logging in with an existing alias replaces the stored profile (including any previous overrides) and makes it active.