Skip to main content

clouder ctx

Manage Clouder contexts. A context represents a cloud provider project or subscription that Clouder operates against. Contexts are stored in ~/.clouder/ and determine which cloud account, region, and project are used for all operations.

Commands​

clouder ctx init​

Initialize the context from available cloud projects.

clouder ctx init

Scans configured cloud providers and creates local context entries for discovered projects and subscriptions.


clouder ctx sync​

Discover the currently accessible Azure subscriptions and AWS account, then create or update local context entries.

clouder ctx sync

This command is non-destructive for existing entries: it updates discovered Azure/AWS context names and adds missing IDs, while leaving other clouds (for example ovh) untouched.


clouder ctx ls​

List all available cloud contexts/projects.

clouder ctx ls

Shows all contexts that have been initialized, including their cloud provider and project ID.


clouder ctx show​

Show the current active context.

clouder ctx show

Displays the currently selected cloud provider, project/subscription ID, and region.


clouder ctx set​

Set the default context to a specific cloud provider and project.

clouder ctx set <cloud> <context-id>
ArgumentDescription
cloudCloud provider: ovh, azure, aws
context_idThe project or subscription ID

Behavior notes:

  • Switches the active current context to the selected cloud/id.
  • Preserves existing context metadata (name and provider-specific details) if the context already exists locally.
  • Creates a new local entry only when the context id is not present yet.

Examples:

# Set context to an Azure subscription
clouder ctx set azure 62042450-8388-4955-8983-77669e536e1e

# Set context to an OVH project
clouder ctx set ovh abc123def456

clouder ctx rm​

Remove a context.

clouder ctx rm <cloud> <context-id>

Removes the specified context from the local configuration.


Example Workflow​

# Initialize contexts from all configured cloud providers
clouder ctx init

# Refresh Azure/AWS contexts from current credentials
clouder ctx sync

# See what's available
clouder ctx ls

# Switch to your Azure subscription
clouder ctx set azure <subscription-id>

# Verify
clouder ctx show