cloud

Manage the optional Clonit Cloud connection.

Usage

clonit cloud [command]

Subcommands

Subcommand	Description
register	Register this agent with Clonit Cloud
status	Show cloud connection status
sync	Sync local target definitions to Clonit Cloud
pull-targets	Import target definitions from Clonit Cloud
targets	List cloud targets
targets add	Add a target to the cloud
snapshots	List cloud snapshots

Description

Clonit Cloud is an optional SaaS extension that adds team collaboration, cross-device access, and snapshot sharing. These commands require cloud.url and cloud.api_key to be configured.

Without cloud configuration, all core Clonit operations work standalone.

To configure the cloud connection, set cloud.url and cloud.api_key with clonit config edit, then run clonit cloud register to register this agent.

---

cloud register

Register this agent with Clonit Cloud.

Usage

clonit cloud register [flags]

Flags

Flag	Type	Default	Description
--force	bool	false	Re-register even if already registered
--name	string	hostname	Agent name

Examples

Register this agent with the cloud (defaults the agent name to the hostname):

clonit cloud register

Register with a custom agent name:

clonit cloud register --name ci-runner-01

Re-register an already-registered agent:

clonit cloud register --force

---

cloud status

Show cloud connection status.

Usage

clonit cloud status

Examples

clonit cloud status

---

cloud sync

Sync local target definitions to Clonit Cloud.

Uploads local target names and database types to Clonit Cloud so they can be accessed from other devices or agents. Sensitive fields (URLs, credentials) are not sent to the cloud.

Usage

clonit cloud sync [flags]

Flags

Flag	Type	Default	Description
--target	string	all	Sync a specific target

Examples

Sync all local targets to the cloud:

clonit cloud sync

Sync a single target:

clonit cloud sync --target mydb

---

cloud pull-targets

Import target definitions from Clonit Cloud.

Downloads target names and database types from Clonit Cloud and creates local target entries. URLs are left empty — fill them in with clonit targets update <name> --src-url <url>. Only targets that don’t already exist locally are imported.

Usage

clonit cloud pull-targets [flags]

Flags

Flag	Type	Default	Description
--name	string	all	Import a specific target

Examples

Import all cloud targets that don’t exist locally:

clonit cloud pull-targets

Import a single target, then fill in its source URL:

clonit cloud pull-targets --name mydb
clonit targets update mydb --src-url "postgres://user:pass@host:5432/mydb"

---

cloud targets

List cloud targets.

Usage

clonit cloud targets

Examples

clonit cloud targets

---

cloud targets add

Add a target to the cloud.

Usage

clonit cloud targets add <name> [flags]

Arguments

Argument	Description	Required
name	Name of the cloud target to add	Yes

Flags

Flag	Type	Default	Description
--db-type	string	postgres	Database type (postgres, mysql)
--description	string		Target description

Examples

Add a cloud target:

clonit cloud targets add mydb

Add a MySQL cloud target with a description:

clonit cloud targets add analytics --db-type mysql --description "Reporting warehouse"

---

cloud snapshots

List cloud snapshots.

Usage

clonit cloud snapshots

Examples

clonit cloud snapshots

See Also

• login – Log in to Clonit Cloud via your browser
• logout – Log out of Clonit Cloud and clear the stored session
• push – Push a snapshot to remote storage (use --cloud for managed storage)
• pull – Pull a snapshot from remote storage (use --cloud for managed storage)
• targets – List local targets
• Clonit Cloud overview – Learn about the optional cloud extension